<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.13.2"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>CAD_Doc: Build/_deps/googletest-src/googletest/include/gtest/gtest.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<script type="text/javascript" src="clipboard.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="cookie.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  $(function() { init_search(); });
/* @license-end */
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr id="projectrow">
  <td id="projectalign">
   <div id="projectname">CAD_Doc<span id="projectnumber">&#160;1.0</span>
   </div>
   <div id="projectbrief">cad synopsis</div>
  </td>
    <td>        <div id="MSearchBox" class="MSearchBoxInactive">
        <span class="left">
          <span id="MSearchSelect"                onmouseover="return searchBox.OnSearchSelectShow()"                onmouseout="return searchBox.OnSearchSelectHide()">&#160;</span>
          <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
               onfocus="searchBox.OnSearchFieldFocus(true)" 
               onblur="searchBox.OnSearchFieldFocus(false)" 
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
          </span><span class="right">
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
          </span>
        </div>
</td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.13.2 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search/",'.html');
/* @license-end */
</script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() { codefold.init(0); });
/* @license-end */
</script>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
      <div id="nav-sync" class="sync"></div>
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function(){initNavTree('gtest_8h_source.html',''); initResizable(true); });
/* @license-end */
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<div id="MSearchResults">
<div class="SRPage">
<div id="SRIndex">
<div id="SRResults"></div>
<div class="SRStatus" id="Loading">Loading...</div>
<div class="SRStatus" id="Searching">Searching...</div>
<div class="SRStatus" id="NoMatches">No Matches</div>
</div>
</div>
</div>
</div>

<div class="header">
  <div class="headertitle"><div class="title">gtest.h</div></div>
</div><!--header-->
<div class="contents">
<div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">// Copyright 2005, Google Inc.</span></div>
<div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment">// All rights reserved.</span></div>
<div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment">//</span></div>
<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">// Redistribution and use in source and binary forms, with or without</span></div>
<div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment">// modification, are permitted provided that the following conditions are</span></div>
<div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment">// met:</span></div>
<div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment">//</span></div>
<div class="line"><a id="l00008" name="l00008"></a><span class="lineno">    8</span><span class="comment">//     * Redistributions of source code must retain the above copyright</span></div>
<div class="line"><a id="l00009" name="l00009"></a><span class="lineno">    9</span><span class="comment">// notice, this list of conditions and the following disclaimer.</span></div>
<div class="line"><a id="l00010" name="l00010"></a><span class="lineno">   10</span><span class="comment">//     * Redistributions in binary form must reproduce the above</span></div>
<div class="line"><a id="l00011" name="l00011"></a><span class="lineno">   11</span><span class="comment">// copyright notice, this list of conditions and the following disclaimer</span></div>
<div class="line"><a id="l00012" name="l00012"></a><span class="lineno">   12</span><span class="comment">// in the documentation and/or other materials provided with the</span></div>
<div class="line"><a id="l00013" name="l00013"></a><span class="lineno">   13</span><span class="comment">// distribution.</span></div>
<div class="line"><a id="l00014" name="l00014"></a><span class="lineno">   14</span><span class="comment">//     * Neither the name of Google Inc. nor the names of its</span></div>
<div class="line"><a id="l00015" name="l00015"></a><span class="lineno">   15</span><span class="comment">// contributors may be used to endorse or promote products derived from</span></div>
<div class="line"><a id="l00016" name="l00016"></a><span class="lineno">   16</span><span class="comment">// this software without specific prior written permission.</span></div>
<div class="line"><a id="l00017" name="l00017"></a><span class="lineno">   17</span><span class="comment">//</span></div>
<div class="line"><a id="l00018" name="l00018"></a><span class="lineno">   18</span><span class="comment">// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS</span></div>
<div class="line"><a id="l00019" name="l00019"></a><span class="lineno">   19</span><span class="comment">// &quot;AS IS&quot; AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT</span></div>
<div class="line"><a id="l00020" name="l00020"></a><span class="lineno">   20</span><span class="comment">// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR</span></div>
<div class="line"><a id="l00021" name="l00021"></a><span class="lineno">   21</span><span class="comment">// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT</span></div>
<div class="line"><a id="l00022" name="l00022"></a><span class="lineno">   22</span><span class="comment">// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,</span></div>
<div class="line"><a id="l00023" name="l00023"></a><span class="lineno">   23</span><span class="comment">// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT</span></div>
<div class="line"><a id="l00024" name="l00024"></a><span class="lineno">   24</span><span class="comment">// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,</span></div>
<div class="line"><a id="l00025" name="l00025"></a><span class="lineno">   25</span><span class="comment">// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY</span></div>
<div class="line"><a id="l00026" name="l00026"></a><span class="lineno">   26</span><span class="comment">// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT</span></div>
<div class="line"><a id="l00027" name="l00027"></a><span class="lineno">   27</span><span class="comment">// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE</span></div>
<div class="line"><a id="l00028" name="l00028"></a><span class="lineno">   28</span><span class="comment">// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</span></div>
<div class="line"><a id="l00029" name="l00029"></a><span class="lineno">   29</span> </div>
<div class="line"><a id="l00030" name="l00030"></a><span class="lineno">   30</span><span class="comment">// The Google C++ Testing and Mocking Framework (Google Test)</span></div>
<div class="line"><a id="l00031" name="l00031"></a><span class="lineno">   31</span><span class="comment">//</span></div>
<div class="line"><a id="l00032" name="l00032"></a><span class="lineno">   32</span><span class="comment">// This header file defines the public API for Google Test.  It should be</span></div>
<div class="line"><a id="l00033" name="l00033"></a><span class="lineno">   33</span><span class="comment">// included by any test program that uses Google Test.</span></div>
<div class="line"><a id="l00034" name="l00034"></a><span class="lineno">   34</span><span class="comment">//</span></div>
<div class="line"><a id="l00035" name="l00035"></a><span class="lineno">   35</span><span class="comment">// IMPORTANT NOTE: Due to limitation of the C++ language, we have to</span></div>
<div class="line"><a id="l00036" name="l00036"></a><span class="lineno">   36</span><span class="comment">// leave some internal implementation details in this header file.</span></div>
<div class="line"><a id="l00037" name="l00037"></a><span class="lineno">   37</span><span class="comment">// They are clearly marked by comments like this:</span></div>
<div class="line"><a id="l00038" name="l00038"></a><span class="lineno">   38</span><span class="comment">//</span></div>
<div class="line"><a id="l00039" name="l00039"></a><span class="lineno">   39</span><span class="comment">//   // INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l00040" name="l00040"></a><span class="lineno">   40</span><span class="comment">//</span></div>
<div class="line"><a id="l00041" name="l00041"></a><span class="lineno">   41</span><span class="comment">// Such code is NOT meant to be used by a user directly, and is subject</span></div>
<div class="line"><a id="l00042" name="l00042"></a><span class="lineno">   42</span><span class="comment">// to CHANGE WITHOUT NOTICE.  Therefore DO NOT DEPEND ON IT in a user</span></div>
<div class="line"><a id="l00043" name="l00043"></a><span class="lineno">   43</span><span class="comment">// program!</span></div>
<div class="line"><a id="l00044" name="l00044"></a><span class="lineno">   44</span><span class="comment">//</span></div>
<div class="line"><a id="l00045" name="l00045"></a><span class="lineno">   45</span><span class="comment">// Acknowledgment: Google Test borrowed the idea of automatic test</span></div>
<div class="line"><a id="l00046" name="l00046"></a><span class="lineno">   46</span><span class="comment">// registration from Barthelemy Dagenais&#39; (barthelemy@prologique.com)</span></div>
<div class="line"><a id="l00047" name="l00047"></a><span class="lineno">   47</span><span class="comment">// easyUnit framework.</span></div>
<div class="line"><a id="l00048" name="l00048"></a><span class="lineno">   48</span> </div>
<div class="line"><a id="l00049" name="l00049"></a><span class="lineno">   49</span><span class="preprocessor">#ifndef GOOGLETEST_INCLUDE_GTEST_GTEST_H_</span></div>
<div class="line"><a id="l00050" name="l00050"></a><span class="lineno">   50</span><span class="preprocessor">#define GOOGLETEST_INCLUDE_GTEST_GTEST_H_</span></div>
<div class="line"><a id="l00051" name="l00051"></a><span class="lineno">   51</span> </div>
<div class="line"><a id="l00052" name="l00052"></a><span class="lineno">   52</span><span class="preprocessor">#include &lt;cstddef&gt;</span></div>
<div class="line"><a id="l00053" name="l00053"></a><span class="lineno">   53</span><span class="preprocessor">#include &lt;limits&gt;</span></div>
<div class="line"><a id="l00054" name="l00054"></a><span class="lineno">   54</span><span class="preprocessor">#include &lt;memory&gt;</span></div>
<div class="line"><a id="l00055" name="l00055"></a><span class="lineno">   55</span><span class="preprocessor">#include &lt;ostream&gt;</span></div>
<div class="line"><a id="l00056" name="l00056"></a><span class="lineno">   56</span><span class="preprocessor">#include &lt;type_traits&gt;</span></div>
<div class="line"><a id="l00057" name="l00057"></a><span class="lineno">   57</span><span class="preprocessor">#include &lt;vector&gt;</span></div>
<div class="line"><a id="l00058" name="l00058"></a><span class="lineno">   58</span> </div>
<div class="line"><a id="l00059" name="l00059"></a><span class="lineno">   59</span><span class="preprocessor">#include &quot;gtest/gtest-assertion-result.h&quot;</span></div>
<div class="line"><a id="l00060" name="l00060"></a><span class="lineno">   60</span><span class="preprocessor">#include &quot;gtest/gtest-death-test.h&quot;</span></div>
<div class="line"><a id="l00061" name="l00061"></a><span class="lineno">   61</span><span class="preprocessor">#include &quot;gtest/gtest-matchers.h&quot;</span></div>
<div class="line"><a id="l00062" name="l00062"></a><span class="lineno">   62</span><span class="preprocessor">#include &quot;gtest/gtest-message.h&quot;</span></div>
<div class="line"><a id="l00063" name="l00063"></a><span class="lineno">   63</span><span class="preprocessor">#include &quot;gtest/gtest-param-test.h&quot;</span></div>
<div class="line"><a id="l00064" name="l00064"></a><span class="lineno">   64</span><span class="preprocessor">#include &quot;gtest/gtest-printers.h&quot;</span></div>
<div class="line"><a id="l00065" name="l00065"></a><span class="lineno">   65</span><span class="preprocessor">#include &quot;gtest/gtest-test-part.h&quot;</span></div>
<div class="line"><a id="l00066" name="l00066"></a><span class="lineno">   66</span><span class="preprocessor">#include &quot;gtest/gtest-typed-test.h&quot;</span></div>
<div class="line"><a id="l00067" name="l00067"></a><span class="lineno">   67</span><span class="preprocessor">#include &quot;gtest/gtest_pred_impl.h&quot;</span></div>
<div class="line"><a id="l00068" name="l00068"></a><span class="lineno">   68</span><span class="preprocessor">#include &quot;gtest/gtest_prod.h&quot;</span></div>
<div class="line"><a id="l00069" name="l00069"></a><span class="lineno">   69</span><span class="preprocessor">#include &quot;gtest/internal/gtest-internal.h&quot;</span></div>
<div class="line"><a id="l00070" name="l00070"></a><span class="lineno">   70</span><span class="preprocessor">#include &quot;gtest/internal/gtest-string.h&quot;</span></div>
<div class="line"><a id="l00071" name="l00071"></a><span class="lineno">   71</span> </div>
<div class="line"><a id="l00072" name="l00072"></a><span class="lineno">   72</span>GTEST_DISABLE_MSC_WARNINGS_PUSH_(4251 \</div>
<div class="line"><a id="l00073" name="l00073"></a><span class="lineno">   73</span><span class="comment">/* class A needs to have dll-interface to be used by clients of class B */</span>)</div>
<div class="line"><a id="l00074" name="l00074"></a><span class="lineno">   74</span> </div>
<div class="line"><a id="l00075" name="l00075"></a><span class="lineno">   75</span><span class="comment">// Declares the flags.</span></div>
<div class="line"><a id="l00076" name="l00076"></a><span class="lineno">   76</span> </div>
<div class="line"><a id="l00077" name="l00077"></a><span class="lineno">   77</span><span class="comment">// This flag temporary enables the disabled tests.</span></div>
<div class="line"><a id="l00078" name="l00078"></a><span class="lineno">   78</span>GTEST_DECLARE_bool_(also_run_disabled_tests);</div>
<div class="line"><a id="l00079" name="l00079"></a><span class="lineno">   79</span> </div>
<div class="line"><a id="l00080" name="l00080"></a><span class="lineno">   80</span><span class="comment">// This flag brings the debugger on an assertion failure.</span></div>
<div class="line"><a id="l00081" name="l00081"></a><span class="lineno">   81</span>GTEST_DECLARE_bool_(break_on_failure);</div>
<div class="line"><a id="l00082" name="l00082"></a><span class="lineno">   82</span> </div>
<div class="line"><a id="l00083" name="l00083"></a><span class="lineno">   83</span><span class="comment">// This flag controls whether Google Test catches all test-thrown exceptions</span></div>
<div class="line"><a id="l00084" name="l00084"></a><span class="lineno">   84</span><span class="comment">// and logs them as failures.</span></div>
<div class="line"><a id="l00085" name="l00085"></a><span class="lineno">   85</span>GTEST_DECLARE_bool_(catch_exceptions);</div>
<div class="line"><a id="l00086" name="l00086"></a><span class="lineno">   86</span> </div>
<div class="line"><a id="l00087" name="l00087"></a><span class="lineno">   87</span><span class="comment">// This flag enables using colors in terminal output. Available values are</span></div>
<div class="line"><a id="l00088" name="l00088"></a><span class="lineno">   88</span><span class="comment">// &quot;yes&quot; to enable colors, &quot;no&quot; (disable colors), or &quot;auto&quot; (the default)</span></div>
<div class="line"><a id="l00089" name="l00089"></a><span class="lineno">   89</span><span class="comment">// to let Google Test decide.</span></div>
<div class="line"><a id="l00090" name="l00090"></a><span class="lineno">   90</span>GTEST_DECLARE_string_(color);</div>
<div class="line"><a id="l00091" name="l00091"></a><span class="lineno">   91</span> </div>
<div class="line"><a id="l00092" name="l00092"></a><span class="lineno">   92</span><span class="comment">// This flag controls whether the test runner should continue execution past</span></div>
<div class="line"><a id="l00093" name="l00093"></a><span class="lineno">   93</span><span class="comment">// first failure.</span></div>
<div class="line"><a id="l00094" name="l00094"></a><span class="lineno">   94</span>GTEST_DECLARE_bool_(fail_fast);</div>
<div class="line"><a id="l00095" name="l00095"></a><span class="lineno">   95</span> </div>
<div class="line"><a id="l00096" name="l00096"></a><span class="lineno">   96</span><span class="comment">// This flag sets up the filter to select by name using a glob pattern</span></div>
<div class="line"><a id="l00097" name="l00097"></a><span class="lineno">   97</span><span class="comment">// the tests to run. If the filter is not given all tests are executed.</span></div>
<div class="line"><a id="l00098" name="l00098"></a><span class="lineno">   98</span>GTEST_DECLARE_string_(filter);</div>
<div class="line"><a id="l00099" name="l00099"></a><span class="lineno">   99</span> </div>
<div class="line"><a id="l00100" name="l00100"></a><span class="lineno">  100</span><span class="comment">// This flag controls whether Google Test installs a signal handler that dumps</span></div>
<div class="line"><a id="l00101" name="l00101"></a><span class="lineno">  101</span><span class="comment">// debugging information when fatal signals are raised.</span></div>
<div class="line"><a id="l00102" name="l00102"></a><span class="lineno">  102</span>GTEST_DECLARE_bool_(install_failure_signal_handler);</div>
<div class="line"><a id="l00103" name="l00103"></a><span class="lineno">  103</span> </div>
<div class="line"><a id="l00104" name="l00104"></a><span class="lineno">  104</span><span class="comment">// This flag causes the Google Test to list tests. None of the tests listed</span></div>
<div class="line"><a id="l00105" name="l00105"></a><span class="lineno">  105</span><span class="comment">// are actually run if the flag is provided.</span></div>
<div class="line"><a id="l00106" name="l00106"></a><span class="lineno">  106</span>GTEST_DECLARE_bool_(list_tests);</div>
<div class="line"><a id="l00107" name="l00107"></a><span class="lineno">  107</span> </div>
<div class="line"><a id="l00108" name="l00108"></a><span class="lineno">  108</span><span class="comment">// This flag controls whether Google Test emits a detailed XML report to a file</span></div>
<div class="line"><a id="l00109" name="l00109"></a><span class="lineno">  109</span><span class="comment">// in addition to its normal textual output.</span></div>
<div class="line"><a id="l00110" name="l00110"></a><span class="lineno">  110</span>GTEST_DECLARE_string_(output);</div>
<div class="line"><a id="l00111" name="l00111"></a><span class="lineno">  111</span> </div>
<div class="line"><a id="l00112" name="l00112"></a><span class="lineno">  112</span><span class="comment">// This flags control whether Google Test prints only test failures.</span></div>
<div class="line"><a id="l00113" name="l00113"></a><span class="lineno">  113</span>GTEST_DECLARE_bool_(brief);</div>
<div class="line"><a id="l00114" name="l00114"></a><span class="lineno">  114</span> </div>
<div class="line"><a id="l00115" name="l00115"></a><span class="lineno">  115</span><span class="comment">// This flags control whether Google Test prints the elapsed time for each</span></div>
<div class="line"><a id="l00116" name="l00116"></a><span class="lineno">  116</span><span class="comment">// test.</span></div>
<div class="line"><a id="l00117" name="l00117"></a><span class="lineno">  117</span>GTEST_DECLARE_bool_(print_time);</div>
<div class="line"><a id="l00118" name="l00118"></a><span class="lineno">  118</span> </div>
<div class="line"><a id="l00119" name="l00119"></a><span class="lineno">  119</span><span class="comment">// This flags control whether Google Test prints UTF8 characters as text.</span></div>
<div class="line"><a id="l00120" name="l00120"></a><span class="lineno">  120</span>GTEST_DECLARE_bool_(print_utf8);</div>
<div class="line"><a id="l00121" name="l00121"></a><span class="lineno">  121</span> </div>
<div class="line"><a id="l00122" name="l00122"></a><span class="lineno">  122</span><span class="comment">// This flag specifies the random number seed.</span></div>
<div class="line"><a id="l00123" name="l00123"></a><span class="lineno">  123</span>GTEST_DECLARE_int32_(random_seed);</div>
<div class="line"><a id="l00124" name="l00124"></a><span class="lineno">  124</span> </div>
<div class="line"><a id="l00125" name="l00125"></a><span class="lineno">  125</span><span class="comment">// This flag sets how many times the tests are repeated. The default value</span></div>
<div class="line"><a id="l00126" name="l00126"></a><span class="lineno">  126</span><span class="comment">// is 1. If the value is -1 the tests are repeating forever.</span></div>
<div class="line"><a id="l00127" name="l00127"></a><span class="lineno">  127</span>GTEST_DECLARE_int32_(repeat);</div>
<div class="line"><a id="l00128" name="l00128"></a><span class="lineno">  128</span> </div>
<div class="line"><a id="l00129" name="l00129"></a><span class="lineno">  129</span><span class="comment">// This flag controls whether Google Test Environments are recreated for each</span></div>
<div class="line"><a id="l00130" name="l00130"></a><span class="lineno">  130</span><span class="comment">// repeat of the tests. The default value is true. If set to false the global</span></div>
<div class="line"><a id="l00131" name="l00131"></a><span class="lineno">  131</span><span class="comment">// test Environment objects are only set up once, for the first iteration, and</span></div>
<div class="line"><a id="l00132" name="l00132"></a><span class="lineno">  132</span><span class="comment">// only torn down once, for the last.</span></div>
<div class="line"><a id="l00133" name="l00133"></a><span class="lineno">  133</span>GTEST_DECLARE_bool_(recreate_environments_when_repeating);</div>
<div class="line"><a id="l00134" name="l00134"></a><span class="lineno">  134</span> </div>
<div class="line"><a id="l00135" name="l00135"></a><span class="lineno">  135</span><span class="comment">// This flag controls whether Google Test includes Google Test internal</span></div>
<div class="line"><a id="l00136" name="l00136"></a><span class="lineno">  136</span><span class="comment">// stack frames in failure stack traces.</span></div>
<div class="line"><a id="l00137" name="l00137"></a><span class="lineno">  137</span>GTEST_DECLARE_bool_(show_internal_stack_frames);</div>
<div class="line"><a id="l00138" name="l00138"></a><span class="lineno">  138</span> </div>
<div class="line"><a id="l00139" name="l00139"></a><span class="lineno">  139</span><span class="comment">// When this flag is specified, tests&#39; order is randomized on every iteration.</span></div>
<div class="line"><a id="l00140" name="l00140"></a><span class="lineno">  140</span>GTEST_DECLARE_bool_(shuffle);</div>
<div class="line"><a id="l00141" name="l00141"></a><span class="lineno">  141</span> </div>
<div class="line"><a id="l00142" name="l00142"></a><span class="lineno">  142</span><span class="comment">// This flag specifies the maximum number of stack frames to be</span></div>
<div class="line"><a id="l00143" name="l00143"></a><span class="lineno">  143</span><span class="comment">// printed in a failure message.</span></div>
<div class="line"><a id="l00144" name="l00144"></a><span class="lineno">  144</span>GTEST_DECLARE_int32_(stack_trace_depth);</div>
<div class="line"><a id="l00145" name="l00145"></a><span class="lineno">  145</span> </div>
<div class="line"><a id="l00146" name="l00146"></a><span class="lineno">  146</span><span class="comment">// When this flag is specified, a failed assertion will throw an</span></div>
<div class="line"><a id="l00147" name="l00147"></a><span class="lineno">  147</span><span class="comment">// exception if exceptions are enabled, or exit the program with a</span></div>
<div class="line"><a id="l00148" name="l00148"></a><span class="lineno">  148</span><span class="comment">// non-zero code otherwise. For use with an external test framework.</span></div>
<div class="line"><a id="l00149" name="l00149"></a><span class="lineno">  149</span>GTEST_DECLARE_bool_(throw_on_failure);</div>
<div class="line"><a id="l00150" name="l00150"></a><span class="lineno">  150</span> </div>
<div class="line"><a id="l00151" name="l00151"></a><span class="lineno">  151</span><span class="comment">// When this flag is set with a &quot;host:port&quot; string, on supported</span></div>
<div class="line"><a id="l00152" name="l00152"></a><span class="lineno">  152</span><span class="comment">// platforms test results are streamed to the specified port on</span></div>
<div class="line"><a id="l00153" name="l00153"></a><span class="lineno">  153</span><span class="comment">// the specified host machine.</span></div>
<div class="line"><a id="l00154" name="l00154"></a><span class="lineno">  154</span>GTEST_DECLARE_string_(stream_result_to);</div>
<div class="line"><a id="l00155" name="l00155"></a><span class="lineno">  155</span> </div>
<div class="line"><a id="l00156" name="l00156"></a><span class="lineno">  156</span><span class="preprocessor">#if GTEST_USE_OWN_FLAGFILE_FLAG_</span></div>
<div class="line"><a id="l00157" name="l00157"></a><span class="lineno">  157</span>GTEST_DECLARE_string_(flagfile);</div>
<div class="line"><a id="l00158" name="l00158"></a><span class="lineno">  158</span><span class="preprocessor">#endif  </span><span class="comment">// GTEST_USE_OWN_FLAGFILE_FLAG_</span></div>
<div class="line"><a id="l00159" name="l00159"></a><span class="lineno">  159</span> </div>
<div class="line"><a id="l00160" name="l00160"></a><span class="lineno">  160</span><span class="keyword">namespace </span>testing {</div>
<div class="line"><a id="l00161" name="l00161"></a><span class="lineno">  161</span> </div>
<div class="line"><a id="l00162" name="l00162"></a><span class="lineno">  162</span><span class="comment">// Silence C4100 (unreferenced formal parameter) and 4805</span></div>
<div class="line"><a id="l00163" name="l00163"></a><span class="lineno">  163</span><span class="comment">// unsafe mix of type &#39;const int&#39; and type &#39;const bool&#39;</span></div>
<div class="line"><a id="l00164" name="l00164"></a><span class="lineno">  164</span><span class="preprocessor">#ifdef _MSC_VER</span></div>
<div class="line"><a id="l00165" name="l00165"></a><span class="lineno">  165</span><span class="preprocessor">#pragma warning(push)</span></div>
<div class="line"><a id="l00166" name="l00166"></a><span class="lineno">  166</span><span class="preprocessor">#pragma warning(disable : 4805)</span></div>
<div class="line"><a id="l00167" name="l00167"></a><span class="lineno">  167</span><span class="preprocessor">#pragma warning(disable : 4100)</span></div>
<div class="line"><a id="l00168" name="l00168"></a><span class="lineno">  168</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l00169" name="l00169"></a><span class="lineno">  169</span> </div>
<div class="line"><a id="l00170" name="l00170"></a><span class="lineno">  170</span><span class="comment">// The upper limit for valid stack trace depths.</span></div>
<div class="line"><a id="l00171" name="l00171"></a><span class="lineno">  171</span><span class="keyword">const</span> <span class="keywordtype">int</span> kMaxStackTraceDepth = 100;</div>
<div class="line"><a id="l00172" name="l00172"></a><span class="lineno">  172</span> </div>
<div class="line"><a id="l00173" name="l00173"></a><span class="lineno">  173</span><span class="keyword">namespace </span>internal {</div>
<div class="line"><a id="l00174" name="l00174"></a><span class="lineno">  174</span> </div>
<div class="line"><a id="l00175" name="l00175"></a><span class="lineno">  175</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_assert_helper.html">AssertHelper</a>;</div>
<div class="line"><a id="l00176" name="l00176"></a><span class="lineno">  176</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_default_global_test_part_result_reporter.html">DefaultGlobalTestPartResultReporter</a>;</div>
<div class="line"><a id="l00177" name="l00177"></a><span class="lineno">  177</span><span class="keyword">class </span>ExecDeathTest;</div>
<div class="line"><a id="l00178" name="l00178"></a><span class="lineno">  178</span><span class="keyword">class </span>NoExecDeathTest;</div>
<div class="line"><a id="l00179" name="l00179"></a><span class="lineno">  179</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_final_success_checker.html">FinalSuccessChecker</a>;</div>
<div class="line"><a id="l00180" name="l00180"></a><span class="lineno">  180</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_g_test_flag_saver.html">GTestFlagSaver</a>;</div>
<div class="line"><a id="l00181" name="l00181"></a><span class="lineno">  181</span><span class="keyword">class </span>StreamingListenerTest;</div>
<div class="line"><a id="l00182" name="l00182"></a><span class="lineno">  182</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_test_result_accessor.html">TestResultAccessor</a>;</div>
<div class="line"><a id="l00183" name="l00183"></a><span class="lineno">  183</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_test_event_listeners_accessor.html">TestEventListenersAccessor</a>;</div>
<div class="line"><a id="l00184" name="l00184"></a><span class="lineno">  184</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_test_event_repeater.html">TestEventRepeater</a>;</div>
<div class="line"><a id="l00185" name="l00185"></a><span class="lineno">  185</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_unit_test_record_property_test_helper.html">UnitTestRecordPropertyTestHelper</a>;</div>
<div class="line"><a id="l00186" name="l00186"></a><span class="lineno">  186</span><span class="keyword">class </span>WindowsDeathTest;</div>
<div class="line"><a id="l00187" name="l00187"></a><span class="lineno">  187</span><span class="keyword">class </span>FuchsiaDeathTest;</div>
<div class="line"><a id="l00188" name="l00188"></a><span class="lineno">  188</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_unit_test_impl.html">UnitTestImpl</a>* GetUnitTestImpl();</div>
<div class="line"><a id="l00189" name="l00189"></a><span class="lineno">  189</span><span class="keywordtype">void</span> ReportFailureInUnknownLocation(TestPartResult::Type result_type,</div>
<div class="line"><a id="l00190" name="l00190"></a><span class="lineno">  190</span>                                    <span class="keyword">const</span> std::string&amp; message);</div>
<div class="line"><a id="l00191" name="l00191"></a><span class="lineno">  191</span>std::set&lt;std::string&gt;* GetIgnoredParameterizedTestSuites();</div>
<div class="line"><a id="l00192" name="l00192"></a><span class="lineno">  192</span> </div>
<div class="line"><a id="l00193" name="l00193"></a><span class="lineno">  193</span><span class="comment">// A base class that prevents subclasses from being copyable.</span></div>
<div class="line"><a id="l00194" name="l00194"></a><span class="lineno">  194</span><span class="comment">// We do this instead of using &#39;= delete&#39; so as to avoid triggering warnings</span></div>
<div class="line"><a id="l00195" name="l00195"></a><span class="lineno">  195</span><span class="comment">// inside user code regarding any of our declarations.</span></div>
<div class="foldopen" id="foldopen00196" data-start="{" data-end="};">
<div class="line"><a id="l00196" name="l00196"></a><span class="lineno"><a class="line" href="classtesting_1_1internal_1_1_g_test_non_copyable.html">  196</a></span><span class="keyword">class </span>GTestNonCopyable {</div>
<div class="line"><a id="l00197" name="l00197"></a><span class="lineno">  197</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00198" name="l00198"></a><span class="lineno">  198</span>  GTestNonCopyable() = <span class="keywordflow">default</span>;</div>
<div class="line"><a id="l00199" name="l00199"></a><span class="lineno">  199</span>  GTestNonCopyable(<span class="keyword">const</span> GTestNonCopyable &amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00200" name="l00200"></a><span class="lineno">  200</span>  GTestNonCopyable &amp;operator=(<span class="keyword">const</span> GTestNonCopyable &amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00201" name="l00201"></a><span class="lineno">  201</span>  ~GTestNonCopyable() = <span class="keywordflow">default</span>;</div>
<div class="line"><a id="l00202" name="l00202"></a><span class="lineno">  202</span>};</div>
</div>
<div class="line"><a id="l00203" name="l00203"></a><span class="lineno">  203</span> </div>
<div class="line"><a id="l00204" name="l00204"></a><span class="lineno">  204</span>}  <span class="comment">// namespace internal</span></div>
<div class="line"><a id="l00205" name="l00205"></a><span class="lineno">  205</span> </div>
<div class="line"><a id="l00206" name="l00206"></a><span class="lineno">  206</span><span class="comment">// The friend relationship of some of these classes is cyclic.</span></div>
<div class="line"><a id="l00207" name="l00207"></a><span class="lineno">  207</span><span class="comment">// If we don&#39;t forward declare them the compiler might confuse the classes</span></div>
<div class="line"><a id="l00208" name="l00208"></a><span class="lineno">  208</span><span class="comment">// in friendship clauses with same named classes on the scope.</span></div>
<div class="line"><a id="l00209" name="l00209"></a><span class="lineno">  209</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1_test.html">Test</a>;</div>
<div class="line"><a id="l00210" name="l00210"></a><span class="lineno">  210</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1_test_suite.html">TestSuite</a>;</div>
<div class="line"><a id="l00211" name="l00211"></a><span class="lineno">  211</span> </div>
<div class="line"><a id="l00212" name="l00212"></a><span class="lineno">  212</span><span class="comment">// Old API is still available but deprecated</span></div>
<div class="line"><a id="l00213" name="l00213"></a><span class="lineno">  213</span><span class="preprocessor">#ifndef GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l00214" name="l00214"></a><span class="lineno">  214</span><span class="keyword">using </span>TestCase = <a class="code hl_class" href="classtesting_1_1_test_suite.html">TestSuite</a>;</div>
<div class="line"><a id="l00215" name="l00215"></a><span class="lineno">  215</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l00216" name="l00216"></a><span class="lineno">  216</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>;</div>
<div class="line"><a id="l00217" name="l00217"></a><span class="lineno">  217</span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>;</div>
<div class="line"><a id="l00218" name="l00218"></a><span class="lineno">  218</span> </div>
<div class="line"><a id="l00219" name="l00219"></a><span class="lineno">  219</span><span class="comment">// The abstract class that all tests inherit from.</span></div>
<div class="line"><a id="l00220" name="l00220"></a><span class="lineno">  220</span><span class="comment">//</span></div>
<div class="line"><a id="l00221" name="l00221"></a><span class="lineno">  221</span><span class="comment">// In Google Test, a unit test program contains one or many TestSuites, and</span></div>
<div class="line"><a id="l00222" name="l00222"></a><span class="lineno">  222</span><span class="comment">// each TestSuite contains one or many Tests.</span></div>
<div class="line"><a id="l00223" name="l00223"></a><span class="lineno">  223</span><span class="comment">//</span></div>
<div class="line"><a id="l00224" name="l00224"></a><span class="lineno">  224</span><span class="comment">// When you define a test using the TEST macro, you don&#39;t need to</span></div>
<div class="line"><a id="l00225" name="l00225"></a><span class="lineno">  225</span><span class="comment">// explicitly derive from Test - the TEST macro automatically does</span></div>
<div class="line"><a id="l00226" name="l00226"></a><span class="lineno">  226</span><span class="comment">// this for you.</span></div>
<div class="line"><a id="l00227" name="l00227"></a><span class="lineno">  227</span><span class="comment">//</span></div>
<div class="line"><a id="l00228" name="l00228"></a><span class="lineno">  228</span><span class="comment">// The only time you derive from Test is when defining a test fixture</span></div>
<div class="line"><a id="l00229" name="l00229"></a><span class="lineno">  229</span><span class="comment">// to be used in a TEST_F.  For example:</span></div>
<div class="line"><a id="l00230" name="l00230"></a><span class="lineno">  230</span><span class="comment">//</span></div>
<div class="line"><a id="l00231" name="l00231"></a><span class="lineno">  231</span><span class="comment">//   class FooTest : public testing::Test {</span></div>
<div class="line"><a id="l00232" name="l00232"></a><span class="lineno">  232</span><span class="comment">//    protected:</span></div>
<div class="line"><a id="l00233" name="l00233"></a><span class="lineno">  233</span><span class="comment">//     void SetUp() override { ... }</span></div>
<div class="line"><a id="l00234" name="l00234"></a><span class="lineno">  234</span><span class="comment">//     void TearDown() override { ... }</span></div>
<div class="line"><a id="l00235" name="l00235"></a><span class="lineno">  235</span><span class="comment">//     ...</span></div>
<div class="line"><a id="l00236" name="l00236"></a><span class="lineno">  236</span><span class="comment">//   };</span></div>
<div class="line"><a id="l00237" name="l00237"></a><span class="lineno">  237</span><span class="comment">//</span></div>
<div class="line"><a id="l00238" name="l00238"></a><span class="lineno">  238</span><span class="comment">//   TEST_F(FooTest, Bar) { ... }</span></div>
<div class="line"><a id="l00239" name="l00239"></a><span class="lineno">  239</span><span class="comment">//   TEST_F(FooTest, Baz) { ... }</span></div>
<div class="line"><a id="l00240" name="l00240"></a><span class="lineno">  240</span><span class="comment">//</span></div>
<div class="line"><a id="l00241" name="l00241"></a><span class="lineno">  241</span><span class="comment">// Test is not copyable.</span></div>
<div class="foldopen" id="foldopen00242" data-start="{" data-end="};">
<div class="line"><a id="l00242" name="l00242"></a><span class="lineno"><a class="line" href="classtesting_1_1_test.html">  242</a></span><span class="keyword">class </span>GTEST_API_ Test {</div>
<div class="line"><a id="l00243" name="l00243"></a><span class="lineno">  243</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00244" name="l00244"></a><span class="lineno">  244</span>  <span class="keyword">friend</span> <span class="keyword">class </span>TestInfo;</div>
<div class="line"><a id="l00245" name="l00245"></a><span class="lineno">  245</span> </div>
<div class="line"><a id="l00246" name="l00246"></a><span class="lineno">  246</span>  <span class="comment">// The d&#39;tor is virtual as we intend to inherit from Test.</span></div>
<div class="line"><a id="l00247" name="l00247"></a><span class="lineno">  247</span>  <span class="keyword">virtual</span> ~Test();</div>
<div class="line"><a id="l00248" name="l00248"></a><span class="lineno">  248</span> </div>
<div class="line"><a id="l00249" name="l00249"></a><span class="lineno">  249</span>  <span class="comment">// Sets up the stuff shared by all tests in this test suite.</span></div>
<div class="line"><a id="l00250" name="l00250"></a><span class="lineno">  250</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00251" name="l00251"></a><span class="lineno">  251</span>  <span class="comment">// Google Test will call Foo::SetUpTestSuite() before running the first</span></div>
<div class="line"><a id="l00252" name="l00252"></a><span class="lineno">  252</span>  <span class="comment">// test in test suite Foo.  Hence a sub-class can define its own</span></div>
<div class="line"><a id="l00253" name="l00253"></a><span class="lineno">  253</span>  <span class="comment">// SetUpTestSuite() method to shadow the one defined in the super</span></div>
<div class="line"><a id="l00254" name="l00254"></a><span class="lineno">  254</span>  <span class="comment">// class.</span></div>
<div class="line"><a id="l00255" name="l00255"></a><span class="lineno">  255</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> SetUpTestSuite() {}</div>
<div class="line"><a id="l00256" name="l00256"></a><span class="lineno">  256</span> </div>
<div class="line"><a id="l00257" name="l00257"></a><span class="lineno">  257</span>  <span class="comment">// Tears down the stuff shared by all tests in this test suite.</span></div>
<div class="line"><a id="l00258" name="l00258"></a><span class="lineno">  258</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00259" name="l00259"></a><span class="lineno">  259</span>  <span class="comment">// Google Test will call Foo::TearDownTestSuite() after running the last</span></div>
<div class="line"><a id="l00260" name="l00260"></a><span class="lineno">  260</span>  <span class="comment">// test in test suite Foo.  Hence a sub-class can define its own</span></div>
<div class="line"><a id="l00261" name="l00261"></a><span class="lineno">  261</span>  <span class="comment">// TearDownTestSuite() method to shadow the one defined in the super</span></div>
<div class="line"><a id="l00262" name="l00262"></a><span class="lineno">  262</span>  <span class="comment">// class.</span></div>
<div class="line"><a id="l00263" name="l00263"></a><span class="lineno">  263</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> TearDownTestSuite() {}</div>
<div class="line"><a id="l00264" name="l00264"></a><span class="lineno">  264</span> </div>
<div class="line"><a id="l00265" name="l00265"></a><span class="lineno">  265</span>  <span class="comment">// Legacy API is deprecated but still available. Use SetUpTestSuite and</span></div>
<div class="line"><a id="l00266" name="l00266"></a><span class="lineno">  266</span>  <span class="comment">// TearDownTestSuite instead.</span></div>
<div class="line"><a id="l00267" name="l00267"></a><span class="lineno">  267</span><span class="preprocessor">#ifndef GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l00268" name="l00268"></a><span class="lineno">  268</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> TearDownTestCase() {}</div>
<div class="line"><a id="l00269" name="l00269"></a><span class="lineno">  269</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> SetUpTestCase() {}</div>
<div class="line"><a id="l00270" name="l00270"></a><span class="lineno">  270</span><span class="preprocessor">#endif  </span><span class="comment">// GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l00271" name="l00271"></a><span class="lineno">  271</span> </div>
<div class="line"><a id="l00272" name="l00272"></a><span class="lineno">  272</span>  <span class="comment">// Returns true if and only if the current test has a fatal failure.</span></div>
<div class="line"><a id="l00273" name="l00273"></a><span class="lineno">  273</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> HasFatalFailure();</div>
<div class="line"><a id="l00274" name="l00274"></a><span class="lineno">  274</span> </div>
<div class="line"><a id="l00275" name="l00275"></a><span class="lineno">  275</span>  <span class="comment">// Returns true if and only if the current test has a non-fatal failure.</span></div>
<div class="line"><a id="l00276" name="l00276"></a><span class="lineno">  276</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> HasNonfatalFailure();</div>
<div class="line"><a id="l00277" name="l00277"></a><span class="lineno">  277</span> </div>
<div class="line"><a id="l00278" name="l00278"></a><span class="lineno">  278</span>  <span class="comment">// Returns true if and only if the current test was skipped.</span></div>
<div class="line"><a id="l00279" name="l00279"></a><span class="lineno">  279</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> IsSkipped();</div>
<div class="line"><a id="l00280" name="l00280"></a><span class="lineno">  280</span> </div>
<div class="line"><a id="l00281" name="l00281"></a><span class="lineno">  281</span>  <span class="comment">// Returns true if and only if the current test has a (either fatal or</span></div>
<div class="line"><a id="l00282" name="l00282"></a><span class="lineno">  282</span>  <span class="comment">// non-fatal) failure.</span></div>
<div class="line"><a id="l00283" name="l00283"></a><span class="lineno">  283</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> HasFailure() { <span class="keywordflow">return</span> HasFatalFailure() || HasNonfatalFailure(); }</div>
<div class="line"><a id="l00284" name="l00284"></a><span class="lineno">  284</span> </div>
<div class="line"><a id="l00285" name="l00285"></a><span class="lineno">  285</span>  <span class="comment">// Logs a property for the current test, test suite, or for the entire</span></div>
<div class="line"><a id="l00286" name="l00286"></a><span class="lineno">  286</span>  <span class="comment">// invocation of the test program when used outside of the context of a</span></div>
<div class="line"><a id="l00287" name="l00287"></a><span class="lineno">  287</span>  <span class="comment">// test suite.  Only the last value for a given key is remembered.  These</span></div>
<div class="line"><a id="l00288" name="l00288"></a><span class="lineno">  288</span>  <span class="comment">// are public static so they can be called from utility functions that are</span></div>
<div class="line"><a id="l00289" name="l00289"></a><span class="lineno">  289</span>  <span class="comment">// not members of the test fixture.  Calls to RecordProperty made during</span></div>
<div class="line"><a id="l00290" name="l00290"></a><span class="lineno">  290</span>  <span class="comment">// lifespan of the test (from the moment its constructor starts to the</span></div>
<div class="line"><a id="l00291" name="l00291"></a><span class="lineno">  291</span>  <span class="comment">// moment its destructor finishes) will be output in XML as attributes of</span></div>
<div class="line"><a id="l00292" name="l00292"></a><span class="lineno">  292</span>  <span class="comment">// the &lt;testcase&gt; element.  Properties recorded from fixture&#39;s</span></div>
<div class="line"><a id="l00293" name="l00293"></a><span class="lineno">  293</span>  <span class="comment">// SetUpTestSuite or TearDownTestSuite are logged as attributes of the</span></div>
<div class="line"><a id="l00294" name="l00294"></a><span class="lineno">  294</span>  <span class="comment">// corresponding &lt;testsuite&gt; element.  Calls to RecordProperty made in the</span></div>
<div class="line"><a id="l00295" name="l00295"></a><span class="lineno">  295</span>  <span class="comment">// global context (before or after invocation of RUN_ALL_TESTS and from</span></div>
<div class="line"><a id="l00296" name="l00296"></a><span class="lineno">  296</span>  <span class="comment">// SetUp/TearDown method of Environment objects registered with Google</span></div>
<div class="line"><a id="l00297" name="l00297"></a><span class="lineno">  297</span>  <span class="comment">// Test) will be output as attributes of the &lt;testsuites&gt; element.</span></div>
<div class="line"><a id="l00298" name="l00298"></a><span class="lineno">  298</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> RecordProperty(<span class="keyword">const</span> std::string&amp; key, <span class="keyword">const</span> std::string&amp; value);</div>
<div class="line"><a id="l00299" name="l00299"></a><span class="lineno">  299</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> RecordProperty(<span class="keyword">const</span> std::string&amp; key, <span class="keywordtype">int</span> value);</div>
<div class="line"><a id="l00300" name="l00300"></a><span class="lineno">  300</span> </div>
<div class="line"><a id="l00301" name="l00301"></a><span class="lineno">  301</span> <span class="keyword">protected</span>:</div>
<div class="line"><a id="l00302" name="l00302"></a><span class="lineno">  302</span>  <span class="comment">// Creates a Test object.</span></div>
<div class="line"><a id="l00303" name="l00303"></a><span class="lineno">  303</span>  Test();</div>
<div class="line"><a id="l00304" name="l00304"></a><span class="lineno">  304</span> </div>
<div class="line"><a id="l00305" name="l00305"></a><span class="lineno">  305</span>  <span class="comment">// Sets up the test fixture.</span></div>
<div class="line"><a id="l00306" name="l00306"></a><span class="lineno">  306</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> SetUp();</div>
<div class="line"><a id="l00307" name="l00307"></a><span class="lineno">  307</span> </div>
<div class="line"><a id="l00308" name="l00308"></a><span class="lineno">  308</span>  <span class="comment">// Tears down the test fixture.</span></div>
<div class="line"><a id="l00309" name="l00309"></a><span class="lineno">  309</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> TearDown();</div>
<div class="line"><a id="l00310" name="l00310"></a><span class="lineno">  310</span> </div>
<div class="line"><a id="l00311" name="l00311"></a><span class="lineno">  311</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00312" name="l00312"></a><span class="lineno">  312</span>  <span class="comment">// Returns true if and only if the current test has the same fixture class</span></div>
<div class="line"><a id="l00313" name="l00313"></a><span class="lineno">  313</span>  <span class="comment">// as the first test in the current test suite.</span></div>
<div class="line"><a id="l00314" name="l00314"></a><span class="lineno">  314</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> HasSameFixtureClass();</div>
<div class="line"><a id="l00315" name="l00315"></a><span class="lineno">  315</span> </div>
<div class="line"><a id="l00316" name="l00316"></a><span class="lineno">  316</span>  <span class="comment">// Runs the test after the test fixture has been set up.</span></div>
<div class="line"><a id="l00317" name="l00317"></a><span class="lineno">  317</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00318" name="l00318"></a><span class="lineno">  318</span>  <span class="comment">// A sub-class must implement this to define the test logic.</span></div>
<div class="line"><a id="l00319" name="l00319"></a><span class="lineno">  319</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00320" name="l00320"></a><span class="lineno">  320</span>  <span class="comment">// DO NOT OVERRIDE THIS FUNCTION DIRECTLY IN A USER PROGRAM.</span></div>
<div class="line"><a id="l00321" name="l00321"></a><span class="lineno">  321</span>  <span class="comment">// Instead, use the TEST or TEST_F macro.</span></div>
<div class="line"><a id="l00322" name="l00322"></a><span class="lineno">  322</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> TestBody() = 0;</div>
<div class="line"><a id="l00323" name="l00323"></a><span class="lineno">  323</span> </div>
<div class="line"><a id="l00324" name="l00324"></a><span class="lineno">  324</span>  <span class="comment">// Sets up, executes, and tears down the test.</span></div>
<div class="line"><a id="l00325" name="l00325"></a><span class="lineno">  325</span>  <span class="keywordtype">void</span> Run();</div>
<div class="line"><a id="l00326" name="l00326"></a><span class="lineno">  326</span> </div>
<div class="line"><a id="l00327" name="l00327"></a><span class="lineno">  327</span>  <span class="comment">// Deletes self.  We deliberately pick an unusual name for this</span></div>
<div class="line"><a id="l00328" name="l00328"></a><span class="lineno">  328</span>  <span class="comment">// internal method to avoid clashing with names used in user TESTs.</span></div>
<div class="line"><a id="l00329" name="l00329"></a><span class="lineno">  329</span>  <span class="keywordtype">void</span> DeleteSelf_() { <span class="keyword">delete</span> <span class="keyword">this</span>; }</div>
<div class="line"><a id="l00330" name="l00330"></a><span class="lineno">  330</span> </div>
<div class="line"><a id="l00331" name="l00331"></a><span class="lineno">  331</span>  <span class="keyword">const</span> std::unique_ptr&lt;GTEST_FLAG_SAVER_&gt; gtest_flag_saver_;</div>
<div class="line"><a id="l00332" name="l00332"></a><span class="lineno">  332</span> </div>
<div class="line"><a id="l00333" name="l00333"></a><span class="lineno">  333</span>  <span class="comment">// Often a user misspells SetUp() as Setup() and spends a long time</span></div>
<div class="line"><a id="l00334" name="l00334"></a><span class="lineno">  334</span>  <span class="comment">// wondering why it is never called by Google Test.  The declaration of</span></div>
<div class="line"><a id="l00335" name="l00335"></a><span class="lineno">  335</span>  <span class="comment">// the following method is solely for catching such an error at</span></div>
<div class="line"><a id="l00336" name="l00336"></a><span class="lineno">  336</span>  <span class="comment">// compile time:</span></div>
<div class="line"><a id="l00337" name="l00337"></a><span class="lineno">  337</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00338" name="l00338"></a><span class="lineno">  338</span>  <span class="comment">//   - The return type is deliberately chosen to be not void, so it</span></div>
<div class="line"><a id="l00339" name="l00339"></a><span class="lineno">  339</span>  <span class="comment">//   will be a conflict if void Setup() is declared in the user&#39;s</span></div>
<div class="line"><a id="l00340" name="l00340"></a><span class="lineno">  340</span>  <span class="comment">//   test fixture.</span></div>
<div class="line"><a id="l00341" name="l00341"></a><span class="lineno">  341</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00342" name="l00342"></a><span class="lineno">  342</span>  <span class="comment">//   - This method is private, so it will be another compiler error</span></div>
<div class="line"><a id="l00343" name="l00343"></a><span class="lineno">  343</span>  <span class="comment">//   if the method is called from the user&#39;s test fixture.</span></div>
<div class="line"><a id="l00344" name="l00344"></a><span class="lineno">  344</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00345" name="l00345"></a><span class="lineno">  345</span>  <span class="comment">// DO NOT OVERRIDE THIS FUNCTION.</span></div>
<div class="line"><a id="l00346" name="l00346"></a><span class="lineno">  346</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00347" name="l00347"></a><span class="lineno">  347</span>  <span class="comment">// If you see an error about overriding the following function or</span></div>
<div class="line"><a id="l00348" name="l00348"></a><span class="lineno">  348</span>  <span class="comment">// about it being private, you have mis-spelled SetUp() as Setup().</span></div>
<div class="line"><a id="l00349" name="l00349"></a><span class="lineno">  349</span>  <span class="keyword">struct </span>Setup_should_be_spelled_SetUp {};</div>
<div class="line"><a id="l00350" name="l00350"></a><span class="lineno">  350</span>  <span class="keyword">virtual</span> Setup_should_be_spelled_SetUp* Setup() { <span class="keywordflow">return</span> <span class="keyword">nullptr</span>; }</div>
<div class="line"><a id="l00351" name="l00351"></a><span class="lineno">  351</span> </div>
<div class="line"><a id="l00352" name="l00352"></a><span class="lineno">  352</span>  <span class="comment">// We disallow copying Tests.</span></div>
<div class="line"><a id="l00353" name="l00353"></a><span class="lineno">  353</span>  Test(<span class="keyword">const</span> Test&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00354" name="l00354"></a><span class="lineno">  354</span>  Test&amp; operator=(<span class="keyword">const</span> Test&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00355" name="l00355"></a><span class="lineno">  355</span>};</div>
</div>
<div class="line"><a id="l00356" name="l00356"></a><span class="lineno">  356</span> </div>
<div class="line"><a id="l00357" name="l00357"></a><span class="lineno">  357</span><span class="keyword">typedef</span> internal::TimeInMillis TimeInMillis;</div>
<div class="line"><a id="l00358" name="l00358"></a><span class="lineno">  358</span> </div>
<div class="line"><a id="l00359" name="l00359"></a><span class="lineno">  359</span><span class="comment">// A copyable object representing a user specified test property which can be</span></div>
<div class="line"><a id="l00360" name="l00360"></a><span class="lineno">  360</span><span class="comment">// output as a key/value string pair.</span></div>
<div class="line"><a id="l00361" name="l00361"></a><span class="lineno">  361</span><span class="comment">//</span></div>
<div class="line"><a id="l00362" name="l00362"></a><span class="lineno">  362</span><span class="comment">// Don&#39;t inherit from TestProperty as its destructor is not virtual.</span></div>
<div class="foldopen" id="foldopen00363" data-start="{" data-end="};">
<div class="line"><a id="l00363" name="l00363"></a><span class="lineno"><a class="line" href="classtesting_1_1_test_property.html">  363</a></span><span class="keyword">class </span>TestProperty {</div>
<div class="line"><a id="l00364" name="l00364"></a><span class="lineno">  364</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00365" name="l00365"></a><span class="lineno">  365</span>  <span class="comment">// C&#39;tor.  TestProperty does NOT have a default constructor.</span></div>
<div class="line"><a id="l00366" name="l00366"></a><span class="lineno">  366</span>  <span class="comment">// Always use this constructor (with parameters) to create a</span></div>
<div class="line"><a id="l00367" name="l00367"></a><span class="lineno">  367</span>  <span class="comment">// TestProperty object.</span></div>
<div class="line"><a id="l00368" name="l00368"></a><span class="lineno">  368</span>  TestProperty(<span class="keyword">const</span> std::string&amp; a_key, <span class="keyword">const</span> std::string&amp; a_value)</div>
<div class="line"><a id="l00369" name="l00369"></a><span class="lineno">  369</span>      : key_(a_key), value_(a_value) {}</div>
<div class="line"><a id="l00370" name="l00370"></a><span class="lineno">  370</span> </div>
<div class="line"><a id="l00371" name="l00371"></a><span class="lineno">  371</span>  <span class="comment">// Gets the user supplied key.</span></div>
<div class="line"><a id="l00372" name="l00372"></a><span class="lineno">  372</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* key()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> key_.c_str(); }</div>
<div class="line"><a id="l00373" name="l00373"></a><span class="lineno">  373</span> </div>
<div class="line"><a id="l00374" name="l00374"></a><span class="lineno">  374</span>  <span class="comment">// Gets the user supplied value.</span></div>
<div class="line"><a id="l00375" name="l00375"></a><span class="lineno">  375</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* value()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> value_.c_str(); }</div>
<div class="line"><a id="l00376" name="l00376"></a><span class="lineno">  376</span> </div>
<div class="line"><a id="l00377" name="l00377"></a><span class="lineno">  377</span>  <span class="comment">// Sets a new value, overriding the one supplied in the constructor.</span></div>
<div class="line"><a id="l00378" name="l00378"></a><span class="lineno">  378</span>  <span class="keywordtype">void</span> SetValue(<span class="keyword">const</span> std::string&amp; new_value) { value_ = new_value; }</div>
<div class="line"><a id="l00379" name="l00379"></a><span class="lineno">  379</span> </div>
<div class="line"><a id="l00380" name="l00380"></a><span class="lineno">  380</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00381" name="l00381"></a><span class="lineno">  381</span>  <span class="comment">// The key supplied by the user.</span></div>
<div class="line"><a id="l00382" name="l00382"></a><span class="lineno">  382</span>  std::string key_;</div>
<div class="line"><a id="l00383" name="l00383"></a><span class="lineno">  383</span>  <span class="comment">// The value supplied by the user.</span></div>
<div class="line"><a id="l00384" name="l00384"></a><span class="lineno">  384</span>  std::string value_;</div>
<div class="line"><a id="l00385" name="l00385"></a><span class="lineno">  385</span>};</div>
</div>
<div class="line"><a id="l00386" name="l00386"></a><span class="lineno">  386</span> </div>
<div class="line"><a id="l00387" name="l00387"></a><span class="lineno">  387</span><span class="comment">// The result of a single Test.  This includes a list of</span></div>
<div class="line"><a id="l00388" name="l00388"></a><span class="lineno">  388</span><span class="comment">// TestPartResults, a list of TestProperties, a count of how many</span></div>
<div class="line"><a id="l00389" name="l00389"></a><span class="lineno">  389</span><span class="comment">// death tests there are in the Test, and how much time it took to run</span></div>
<div class="line"><a id="l00390" name="l00390"></a><span class="lineno">  390</span><span class="comment">// the Test.</span></div>
<div class="line"><a id="l00391" name="l00391"></a><span class="lineno">  391</span><span class="comment">//</span></div>
<div class="line"><a id="l00392" name="l00392"></a><span class="lineno">  392</span><span class="comment">// TestResult is not copyable.</span></div>
<div class="foldopen" id="foldopen00393" data-start="{" data-end="};">
<div class="line"><a id="l00393" name="l00393"></a><span class="lineno"><a class="line" href="classtesting_1_1_test_result.html">  393</a></span><span class="keyword">class </span>GTEST_API_ TestResult {</div>
<div class="line"><a id="l00394" name="l00394"></a><span class="lineno">  394</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00395" name="l00395"></a><span class="lineno">  395</span>  <span class="comment">// Creates an empty TestResult.</span></div>
<div class="line"><a id="l00396" name="l00396"></a><span class="lineno">  396</span>  TestResult();</div>
<div class="line"><a id="l00397" name="l00397"></a><span class="lineno">  397</span> </div>
<div class="line"><a id="l00398" name="l00398"></a><span class="lineno">  398</span>  <span class="comment">// D&#39;tor.  Do not inherit from TestResult.</span></div>
<div class="line"><a id="l00399" name="l00399"></a><span class="lineno">  399</span>  ~TestResult();</div>
<div class="line"><a id="l00400" name="l00400"></a><span class="lineno">  400</span> </div>
<div class="line"><a id="l00401" name="l00401"></a><span class="lineno">  401</span>  <span class="comment">// Gets the number of all test parts.  This is the sum of the number</span></div>
<div class="line"><a id="l00402" name="l00402"></a><span class="lineno">  402</span>  <span class="comment">// of successful test parts and the number of failed test parts.</span></div>
<div class="line"><a id="l00403" name="l00403"></a><span class="lineno">  403</span>  <span class="keywordtype">int</span> total_part_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00404" name="l00404"></a><span class="lineno">  404</span> </div>
<div class="line"><a id="l00405" name="l00405"></a><span class="lineno">  405</span>  <span class="comment">// Returns the number of the test properties.</span></div>
<div class="line"><a id="l00406" name="l00406"></a><span class="lineno">  406</span>  <span class="keywordtype">int</span> test_property_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00407" name="l00407"></a><span class="lineno">  407</span> </div>
<div class="line"><a id="l00408" name="l00408"></a><span class="lineno">  408</span>  <span class="comment">// Returns true if and only if the test passed (i.e. no test part failed).</span></div>
<div class="line"><a id="l00409" name="l00409"></a><span class="lineno">  409</span>  <span class="keywordtype">bool</span> Passed()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> !Skipped() &amp;&amp; !Failed(); }</div>
<div class="line"><a id="l00410" name="l00410"></a><span class="lineno">  410</span> </div>
<div class="line"><a id="l00411" name="l00411"></a><span class="lineno">  411</span>  <span class="comment">// Returns true if and only if the test was skipped.</span></div>
<div class="line"><a id="l00412" name="l00412"></a><span class="lineno">  412</span>  <span class="keywordtype">bool</span> Skipped() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00413" name="l00413"></a><span class="lineno">  413</span> </div>
<div class="line"><a id="l00414" name="l00414"></a><span class="lineno">  414</span>  <span class="comment">// Returns true if and only if the test failed.</span></div>
<div class="line"><a id="l00415" name="l00415"></a><span class="lineno">  415</span>  <span class="keywordtype">bool</span> Failed() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00416" name="l00416"></a><span class="lineno">  416</span> </div>
<div class="line"><a id="l00417" name="l00417"></a><span class="lineno">  417</span>  <span class="comment">// Returns true if and only if the test fatally failed.</span></div>
<div class="line"><a id="l00418" name="l00418"></a><span class="lineno">  418</span>  <span class="keywordtype">bool</span> HasFatalFailure() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00419" name="l00419"></a><span class="lineno">  419</span> </div>
<div class="line"><a id="l00420" name="l00420"></a><span class="lineno">  420</span>  <span class="comment">// Returns true if and only if the test has a non-fatal failure.</span></div>
<div class="line"><a id="l00421" name="l00421"></a><span class="lineno">  421</span>  <span class="keywordtype">bool</span> HasNonfatalFailure() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00422" name="l00422"></a><span class="lineno">  422</span> </div>
<div class="line"><a id="l00423" name="l00423"></a><span class="lineno">  423</span>  <span class="comment">// Returns the elapsed time, in milliseconds.</span></div>
<div class="line"><a id="l00424" name="l00424"></a><span class="lineno">  424</span>  TimeInMillis elapsed_time()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> elapsed_time_; }</div>
<div class="line"><a id="l00425" name="l00425"></a><span class="lineno">  425</span> </div>
<div class="line"><a id="l00426" name="l00426"></a><span class="lineno">  426</span>  <span class="comment">// Gets the time of the test case start, in ms from the start of the</span></div>
<div class="line"><a id="l00427" name="l00427"></a><span class="lineno">  427</span>  <span class="comment">// UNIX epoch.</span></div>
<div class="line"><a id="l00428" name="l00428"></a><span class="lineno">  428</span>  TimeInMillis start_timestamp()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> start_timestamp_; }</div>
<div class="line"><a id="l00429" name="l00429"></a><span class="lineno">  429</span> </div>
<div class="line"><a id="l00430" name="l00430"></a><span class="lineno">  430</span>  <span class="comment">// Returns the i-th test part result among all the results. i can range from 0</span></div>
<div class="line"><a id="l00431" name="l00431"></a><span class="lineno">  431</span>  <span class="comment">// to total_part_count() - 1. If i is not in that range, aborts the program.</span></div>
<div class="line"><a id="l00432" name="l00432"></a><span class="lineno">  432</span>  <span class="keyword">const</span> TestPartResult&amp; GetTestPartResult(<span class="keywordtype">int</span> i) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00433" name="l00433"></a><span class="lineno">  433</span> </div>
<div class="line"><a id="l00434" name="l00434"></a><span class="lineno">  434</span>  <span class="comment">// Returns the i-th test property. i can range from 0 to</span></div>
<div class="line"><a id="l00435" name="l00435"></a><span class="lineno">  435</span>  <span class="comment">// test_property_count() - 1. If i is not in that range, aborts the</span></div>
<div class="line"><a id="l00436" name="l00436"></a><span class="lineno">  436</span>  <span class="comment">// program.</span></div>
<div class="line"><a id="l00437" name="l00437"></a><span class="lineno">  437</span>  <span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_property.html">TestProperty</a>&amp; GetTestProperty(<span class="keywordtype">int</span> i) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00438" name="l00438"></a><span class="lineno">  438</span> </div>
<div class="line"><a id="l00439" name="l00439"></a><span class="lineno">  439</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00440" name="l00440"></a><span class="lineno">  440</span>  <span class="keyword">friend</span> <span class="keyword">class </span>TestInfo;</div>
<div class="line"><a id="l00441" name="l00441"></a><span class="lineno">  441</span>  <span class="keyword">friend</span> <span class="keyword">class </span>TestSuite;</div>
<div class="line"><a id="l00442" name="l00442"></a><span class="lineno">  442</span>  <span class="keyword">friend</span> <span class="keyword">class </span>UnitTest;</div>
<div class="line"><a id="l00443" name="l00443"></a><span class="lineno">  443</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_default_global_test_part_result_reporter.html">internal::DefaultGlobalTestPartResultReporter</a>;</div>
<div class="line"><a id="l00444" name="l00444"></a><span class="lineno">  444</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::ExecDeathTest;</div>
<div class="line"><a id="l00445" name="l00445"></a><span class="lineno">  445</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_test_result_accessor.html">internal::TestResultAccessor</a>;</div>
<div class="line"><a id="l00446" name="l00446"></a><span class="lineno">  446</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_unit_test_impl.html">internal::UnitTestImpl</a>;</div>
<div class="line"><a id="l00447" name="l00447"></a><span class="lineno">  447</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::WindowsDeathTest;</div>
<div class="line"><a id="l00448" name="l00448"></a><span class="lineno">  448</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::FuchsiaDeathTest;</div>
<div class="line"><a id="l00449" name="l00449"></a><span class="lineno">  449</span> </div>
<div class="line"><a id="l00450" name="l00450"></a><span class="lineno">  450</span>  <span class="comment">// Gets the vector of TestPartResults.</span></div>
<div class="line"><a id="l00451" name="l00451"></a><span class="lineno">  451</span>  <span class="keyword">const</span> std::vector&lt;TestPartResult&gt;&amp; test_part_results()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00452" name="l00452"></a><span class="lineno">  452</span>    <span class="keywordflow">return</span> test_part_results_;</div>
<div class="line"><a id="l00453" name="l00453"></a><span class="lineno">  453</span>  }</div>
<div class="line"><a id="l00454" name="l00454"></a><span class="lineno">  454</span> </div>
<div class="line"><a id="l00455" name="l00455"></a><span class="lineno">  455</span>  <span class="comment">// Gets the vector of TestProperties.</span></div>
<div class="line"><a id="l00456" name="l00456"></a><span class="lineno">  456</span>  <span class="keyword">const</span> std::vector&lt;TestProperty&gt;&amp; test_properties()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00457" name="l00457"></a><span class="lineno">  457</span>    <span class="keywordflow">return</span> test_properties_;</div>
<div class="line"><a id="l00458" name="l00458"></a><span class="lineno">  458</span>  }</div>
<div class="line"><a id="l00459" name="l00459"></a><span class="lineno">  459</span> </div>
<div class="line"><a id="l00460" name="l00460"></a><span class="lineno">  460</span>  <span class="comment">// Sets the start time.</span></div>
<div class="line"><a id="l00461" name="l00461"></a><span class="lineno">  461</span>  <span class="keywordtype">void</span> set_start_timestamp(TimeInMillis start) { start_timestamp_ = start; }</div>
<div class="line"><a id="l00462" name="l00462"></a><span class="lineno">  462</span> </div>
<div class="line"><a id="l00463" name="l00463"></a><span class="lineno">  463</span>  <span class="comment">// Sets the elapsed time.</span></div>
<div class="line"><a id="l00464" name="l00464"></a><span class="lineno">  464</span>  <span class="keywordtype">void</span> set_elapsed_time(TimeInMillis elapsed) { elapsed_time_ = elapsed; }</div>
<div class="line"><a id="l00465" name="l00465"></a><span class="lineno">  465</span> </div>
<div class="line"><a id="l00466" name="l00466"></a><span class="lineno">  466</span>  <span class="comment">// Adds a test property to the list. The property is validated and may add</span></div>
<div class="line"><a id="l00467" name="l00467"></a><span class="lineno">  467</span>  <span class="comment">// a non-fatal failure if invalid (e.g., if it conflicts with reserved</span></div>
<div class="line"><a id="l00468" name="l00468"></a><span class="lineno">  468</span>  <span class="comment">// key names). If a property is already recorded for the same key, the</span></div>
<div class="line"><a id="l00469" name="l00469"></a><span class="lineno">  469</span>  <span class="comment">// value will be updated, rather than storing multiple values for the same</span></div>
<div class="line"><a id="l00470" name="l00470"></a><span class="lineno">  470</span>  <span class="comment">// key.  xml_element specifies the element for which the property is being</span></div>
<div class="line"><a id="l00471" name="l00471"></a><span class="lineno">  471</span>  <span class="comment">// recorded and is used for validation.</span></div>
<div class="line"><a id="l00472" name="l00472"></a><span class="lineno">  472</span>  <span class="keywordtype">void</span> RecordProperty(<span class="keyword">const</span> std::string&amp; xml_element,</div>
<div class="line"><a id="l00473" name="l00473"></a><span class="lineno">  473</span>                      <span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_property.html">TestProperty</a>&amp; test_property);</div>
<div class="line"><a id="l00474" name="l00474"></a><span class="lineno">  474</span> </div>
<div class="line"><a id="l00475" name="l00475"></a><span class="lineno">  475</span>  <span class="comment">// Adds a failure if the key is a reserved attribute of Google Test</span></div>
<div class="line"><a id="l00476" name="l00476"></a><span class="lineno">  476</span>  <span class="comment">// testsuite tags.  Returns true if the property is valid.</span></div>
<div class="line"><a id="l00477" name="l00477"></a><span class="lineno">  477</span>  <span class="comment">// FIXME: Validate attribute names are legal and human readable.</span></div>
<div class="line"><a id="l00478" name="l00478"></a><span class="lineno">  478</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> ValidateTestProperty(<span class="keyword">const</span> std::string&amp; xml_element,</div>
<div class="line"><a id="l00479" name="l00479"></a><span class="lineno">  479</span>                                   <span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_property.html">TestProperty</a>&amp; test_property);</div>
<div class="line"><a id="l00480" name="l00480"></a><span class="lineno">  480</span> </div>
<div class="line"><a id="l00481" name="l00481"></a><span class="lineno">  481</span>  <span class="comment">// Adds a test part result to the list.</span></div>
<div class="line"><a id="l00482" name="l00482"></a><span class="lineno">  482</span>  <span class="keywordtype">void</span> AddTestPartResult(<span class="keyword">const</span> TestPartResult&amp; test_part_result);</div>
<div class="line"><a id="l00483" name="l00483"></a><span class="lineno">  483</span> </div>
<div class="line"><a id="l00484" name="l00484"></a><span class="lineno">  484</span>  <span class="comment">// Returns the death test count.</span></div>
<div class="line"><a id="l00485" name="l00485"></a><span class="lineno">  485</span>  <span class="keywordtype">int</span> death_test_count()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> death_test_count_; }</div>
<div class="line"><a id="l00486" name="l00486"></a><span class="lineno">  486</span> </div>
<div class="line"><a id="l00487" name="l00487"></a><span class="lineno">  487</span>  <span class="comment">// Increments the death test count, returning the new count.</span></div>
<div class="line"><a id="l00488" name="l00488"></a><span class="lineno">  488</span>  <span class="keywordtype">int</span> increment_death_test_count() { <span class="keywordflow">return</span> ++death_test_count_; }</div>
<div class="line"><a id="l00489" name="l00489"></a><span class="lineno">  489</span> </div>
<div class="line"><a id="l00490" name="l00490"></a><span class="lineno">  490</span>  <span class="comment">// Clears the test part results.</span></div>
<div class="line"><a id="l00491" name="l00491"></a><span class="lineno">  491</span>  <span class="keywordtype">void</span> ClearTestPartResults();</div>
<div class="line"><a id="l00492" name="l00492"></a><span class="lineno">  492</span> </div>
<div class="line"><a id="l00493" name="l00493"></a><span class="lineno">  493</span>  <span class="comment">// Clears the object.</span></div>
<div class="line"><a id="l00494" name="l00494"></a><span class="lineno">  494</span>  <span class="keywordtype">void</span> Clear();</div>
<div class="line"><a id="l00495" name="l00495"></a><span class="lineno">  495</span> </div>
<div class="line"><a id="l00496" name="l00496"></a><span class="lineno">  496</span>  <span class="comment">// Protects mutable state of the property vector and of owned</span></div>
<div class="line"><a id="l00497" name="l00497"></a><span class="lineno">  497</span>  <span class="comment">// properties, whose values may be updated.</span></div>
<div class="line"><a id="l00498" name="l00498"></a><span class="lineno">  498</span>  <a class="code hl_class" href="classtesting_1_1internal_1_1_mutex.html">internal::Mutex</a> test_properties_mutex_;</div>
<div class="line"><a id="l00499" name="l00499"></a><span class="lineno">  499</span> </div>
<div class="line"><a id="l00500" name="l00500"></a><span class="lineno">  500</span>  <span class="comment">// The vector of TestPartResults</span></div>
<div class="line"><a id="l00501" name="l00501"></a><span class="lineno">  501</span>  std::vector&lt;TestPartResult&gt; test_part_results_;</div>
<div class="line"><a id="l00502" name="l00502"></a><span class="lineno">  502</span>  <span class="comment">// The vector of TestProperties</span></div>
<div class="line"><a id="l00503" name="l00503"></a><span class="lineno">  503</span>  std::vector&lt;TestProperty&gt; test_properties_;</div>
<div class="line"><a id="l00504" name="l00504"></a><span class="lineno">  504</span>  <span class="comment">// Running count of death tests.</span></div>
<div class="line"><a id="l00505" name="l00505"></a><span class="lineno">  505</span>  <span class="keywordtype">int</span> death_test_count_;</div>
<div class="line"><a id="l00506" name="l00506"></a><span class="lineno">  506</span>  <span class="comment">// The start time, in milliseconds since UNIX Epoch.</span></div>
<div class="line"><a id="l00507" name="l00507"></a><span class="lineno">  507</span>  TimeInMillis start_timestamp_;</div>
<div class="line"><a id="l00508" name="l00508"></a><span class="lineno">  508</span>  <span class="comment">// The elapsed time, in milliseconds.</span></div>
<div class="line"><a id="l00509" name="l00509"></a><span class="lineno">  509</span>  TimeInMillis elapsed_time_;</div>
<div class="line"><a id="l00510" name="l00510"></a><span class="lineno">  510</span> </div>
<div class="line"><a id="l00511" name="l00511"></a><span class="lineno">  511</span>  <span class="comment">// We disallow copying TestResult.</span></div>
<div class="line"><a id="l00512" name="l00512"></a><span class="lineno">  512</span>  TestResult(<span class="keyword">const</span> TestResult&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00513" name="l00513"></a><span class="lineno">  513</span>  TestResult&amp; operator=(<span class="keyword">const</span> TestResult&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00514" name="l00514"></a><span class="lineno">  514</span>};  <span class="comment">// class TestResult</span></div>
</div>
<div class="line"><a id="l00515" name="l00515"></a><span class="lineno">  515</span> </div>
<div class="line"><a id="l00516" name="l00516"></a><span class="lineno">  516</span><span class="comment">// A TestInfo object stores the following information about a test:</span></div>
<div class="line"><a id="l00517" name="l00517"></a><span class="lineno">  517</span><span class="comment">//</span></div>
<div class="line"><a id="l00518" name="l00518"></a><span class="lineno">  518</span><span class="comment">//   Test suite name</span></div>
<div class="line"><a id="l00519" name="l00519"></a><span class="lineno">  519</span><span class="comment">//   Test name</span></div>
<div class="line"><a id="l00520" name="l00520"></a><span class="lineno">  520</span><span class="comment">//   Whether the test should be run</span></div>
<div class="line"><a id="l00521" name="l00521"></a><span class="lineno">  521</span><span class="comment">//   A function pointer that creates the test object when invoked</span></div>
<div class="line"><a id="l00522" name="l00522"></a><span class="lineno">  522</span><span class="comment">//   Test result</span></div>
<div class="line"><a id="l00523" name="l00523"></a><span class="lineno">  523</span><span class="comment">//</span></div>
<div class="line"><a id="l00524" name="l00524"></a><span class="lineno">  524</span><span class="comment">// The constructor of TestInfo registers itself with the UnitTest</span></div>
<div class="line"><a id="l00525" name="l00525"></a><span class="lineno">  525</span><span class="comment">// singleton such that the RUN_ALL_TESTS() macro knows which tests to</span></div>
<div class="line"><a id="l00526" name="l00526"></a><span class="lineno">  526</span><span class="comment">// run.</span></div>
<div class="foldopen" id="foldopen00527" data-start="{" data-end="};">
<div class="line"><a id="l00527" name="l00527"></a><span class="lineno"><a class="line" href="class_test_info.html">  527</a></span><span class="keyword">class </span>GTEST_API_ TestInfo {</div>
<div class="line"><a id="l00528" name="l00528"></a><span class="lineno">  528</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00529" name="l00529"></a><span class="lineno">  529</span>  <span class="comment">// Destructs a TestInfo object.  This function is not virtual, so</span></div>
<div class="line"><a id="l00530" name="l00530"></a><span class="lineno">  530</span>  <span class="comment">// don&#39;t inherit from TestInfo.</span></div>
<div class="line"><a id="l00531" name="l00531"></a><span class="lineno">  531</span>  ~TestInfo();</div>
<div class="line"><a id="l00532" name="l00532"></a><span class="lineno">  532</span> </div>
<div class="line"><a id="l00533" name="l00533"></a><span class="lineno">  533</span>  <span class="comment">// Returns the test suite name.</span></div>
<div class="line"><a id="l00534" name="l00534"></a><span class="lineno">  534</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* test_suite_name()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> test_suite_name_.c_str(); }</div>
<div class="line"><a id="l00535" name="l00535"></a><span class="lineno">  535</span> </div>
<div class="line"><a id="l00536" name="l00536"></a><span class="lineno">  536</span><span class="comment">// Legacy API is deprecated but still available</span></div>
<div class="line"><a id="l00537" name="l00537"></a><span class="lineno">  537</span><span class="preprocessor">#ifndef GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l00538" name="l00538"></a><span class="lineno">  538</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* test_case_name()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> test_suite_name(); }</div>
<div class="line"><a id="l00539" name="l00539"></a><span class="lineno">  539</span><span class="preprocessor">#endif  </span><span class="comment">// GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l00540" name="l00540"></a><span class="lineno">  540</span> </div>
<div class="line"><a id="l00541" name="l00541"></a><span class="lineno">  541</span>  <span class="comment">// Returns the test name.</span></div>
<div class="line"><a id="l00542" name="l00542"></a><span class="lineno">  542</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* name()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> name_.c_str(); }</div>
<div class="line"><a id="l00543" name="l00543"></a><span class="lineno">  543</span> </div>
<div class="line"><a id="l00544" name="l00544"></a><span class="lineno">  544</span>  <span class="comment">// Returns the name of the parameter type, or NULL if this is not a typed</span></div>
<div class="line"><a id="l00545" name="l00545"></a><span class="lineno">  545</span>  <span class="comment">// or a type-parameterized test.</span></div>
<div class="line"><a id="l00546" name="l00546"></a><span class="lineno">  546</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* type_param()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00547" name="l00547"></a><span class="lineno">  547</span>    <span class="keywordflow">if</span> (type_param_.get() != <span class="keyword">nullptr</span>) <span class="keywordflow">return</span> type_param_-&gt;c_str();</div>
<div class="line"><a id="l00548" name="l00548"></a><span class="lineno">  548</span>    <span class="keywordflow">return</span> <span class="keyword">nullptr</span>;</div>
<div class="line"><a id="l00549" name="l00549"></a><span class="lineno">  549</span>  }</div>
<div class="line"><a id="l00550" name="l00550"></a><span class="lineno">  550</span> </div>
<div class="line"><a id="l00551" name="l00551"></a><span class="lineno">  551</span>  <span class="comment">// Returns the text representation of the value parameter, or NULL if this</span></div>
<div class="line"><a id="l00552" name="l00552"></a><span class="lineno">  552</span>  <span class="comment">// is not a value-parameterized test.</span></div>
<div class="line"><a id="l00553" name="l00553"></a><span class="lineno">  553</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* value_param()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00554" name="l00554"></a><span class="lineno">  554</span>    <span class="keywordflow">if</span> (value_param_.get() != <span class="keyword">nullptr</span>) <span class="keywordflow">return</span> value_param_-&gt;c_str();</div>
<div class="line"><a id="l00555" name="l00555"></a><span class="lineno">  555</span>    <span class="keywordflow">return</span> <span class="keyword">nullptr</span>;</div>
<div class="line"><a id="l00556" name="l00556"></a><span class="lineno">  556</span>  }</div>
<div class="line"><a id="l00557" name="l00557"></a><span class="lineno">  557</span> </div>
<div class="line"><a id="l00558" name="l00558"></a><span class="lineno">  558</span>  <span class="comment">// Returns the file name where this test is defined.</span></div>
<div class="line"><a id="l00559" name="l00559"></a><span class="lineno">  559</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* file()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> location_.file.c_str(); }</div>
<div class="line"><a id="l00560" name="l00560"></a><span class="lineno">  560</span> </div>
<div class="line"><a id="l00561" name="l00561"></a><span class="lineno">  561</span>  <span class="comment">// Returns the line where this test is defined.</span></div>
<div class="line"><a id="l00562" name="l00562"></a><span class="lineno">  562</span>  <span class="keywordtype">int</span> line()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> location_.line; }</div>
<div class="line"><a id="l00563" name="l00563"></a><span class="lineno">  563</span> </div>
<div class="line"><a id="l00564" name="l00564"></a><span class="lineno">  564</span>  <span class="comment">// Return true if this test should not be run because it&#39;s in another shard.</span></div>
<div class="line"><a id="l00565" name="l00565"></a><span class="lineno">  565</span>  <span class="keywordtype">bool</span> is_in_another_shard()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> is_in_another_shard_; }</div>
<div class="line"><a id="l00566" name="l00566"></a><span class="lineno">  566</span> </div>
<div class="line"><a id="l00567" name="l00567"></a><span class="lineno">  567</span>  <span class="comment">// Returns true if this test should run, that is if the test is not</span></div>
<div class="line"><a id="l00568" name="l00568"></a><span class="lineno">  568</span>  <span class="comment">// disabled (or it is disabled but the also_run_disabled_tests flag has</span></div>
<div class="line"><a id="l00569" name="l00569"></a><span class="lineno">  569</span>  <span class="comment">// been specified) and its full name matches the user-specified filter.</span></div>
<div class="line"><a id="l00570" name="l00570"></a><span class="lineno">  570</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00571" name="l00571"></a><span class="lineno">  571</span>  <span class="comment">// Google Test allows the user to filter the tests by their full names.</span></div>
<div class="line"><a id="l00572" name="l00572"></a><span class="lineno">  572</span>  <span class="comment">// The full name of a test Bar in test suite Foo is defined as</span></div>
<div class="line"><a id="l00573" name="l00573"></a><span class="lineno">  573</span>  <span class="comment">// &quot;Foo.Bar&quot;.  Only the tests that match the filter will run.</span></div>
<div class="line"><a id="l00574" name="l00574"></a><span class="lineno">  574</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00575" name="l00575"></a><span class="lineno">  575</span>  <span class="comment">// A filter is a colon-separated list of glob (not regex) patterns,</span></div>
<div class="line"><a id="l00576" name="l00576"></a><span class="lineno">  576</span>  <span class="comment">// optionally followed by a &#39;-&#39; and a colon-separated list of</span></div>
<div class="line"><a id="l00577" name="l00577"></a><span class="lineno">  577</span>  <span class="comment">// negative patterns (tests to exclude).  A test is run if it</span></div>
<div class="line"><a id="l00578" name="l00578"></a><span class="lineno">  578</span>  <span class="comment">// matches one of the positive patterns and does not match any of</span></div>
<div class="line"><a id="l00579" name="l00579"></a><span class="lineno">  579</span>  <span class="comment">// the negative patterns.</span></div>
<div class="line"><a id="l00580" name="l00580"></a><span class="lineno">  580</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00581" name="l00581"></a><span class="lineno">  581</span>  <span class="comment">// For example, *A*:Foo.* is a filter that matches any string that</span></div>
<div class="line"><a id="l00582" name="l00582"></a><span class="lineno">  582</span>  <span class="comment">// contains the character &#39;A&#39; or starts with &quot;Foo.&quot;.</span></div>
<div class="line"><a id="l00583" name="l00583"></a><span class="lineno">  583</span>  <span class="keywordtype">bool</span> should_run()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> should_run_; }</div>
<div class="line"><a id="l00584" name="l00584"></a><span class="lineno">  584</span> </div>
<div class="line"><a id="l00585" name="l00585"></a><span class="lineno">  585</span>  <span class="comment">// Returns true if and only if this test will appear in the XML report.</span></div>
<div class="line"><a id="l00586" name="l00586"></a><span class="lineno">  586</span>  <span class="keywordtype">bool</span> is_reportable()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00587" name="l00587"></a><span class="lineno">  587</span>    <span class="comment">// The XML report includes tests matching the filter, excluding those</span></div>
<div class="line"><a id="l00588" name="l00588"></a><span class="lineno">  588</span>    <span class="comment">// run in other shards.</span></div>
<div class="line"><a id="l00589" name="l00589"></a><span class="lineno">  589</span>    <span class="keywordflow">return</span> matches_filter_ &amp;&amp; !is_in_another_shard_;</div>
<div class="line"><a id="l00590" name="l00590"></a><span class="lineno">  590</span>  }</div>
<div class="line"><a id="l00591" name="l00591"></a><span class="lineno">  591</span> </div>
<div class="line"><a id="l00592" name="l00592"></a><span class="lineno">  592</span>  <span class="comment">// Returns the result of the test.</span></div>
<div class="line"><a id="l00593" name="l00593"></a><span class="lineno">  593</span>  <span class="keyword">const</span> <a class="code hl_class" href="class_test_result.html">TestResult</a>* result()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> &amp;result_; }</div>
<div class="line"><a id="l00594" name="l00594"></a><span class="lineno">  594</span> </div>
<div class="line"><a id="l00595" name="l00595"></a><span class="lineno">  595</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00596" name="l00596"></a><span class="lineno">  596</span><span class="preprocessor">#if GTEST_HAS_DEATH_TEST</span></div>
<div class="line"><a id="l00597" name="l00597"></a><span class="lineno">  597</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::DefaultDeathTestFactory;</div>
<div class="line"><a id="l00598" name="l00598"></a><span class="lineno">  598</span><span class="preprocessor">#endif  </span><span class="comment">// GTEST_HAS_DEATH_TEST</span></div>
<div class="line"><a id="l00599" name="l00599"></a><span class="lineno">  599</span>  <span class="keyword">friend</span> <span class="keyword">class </span>Test;</div>
<div class="line"><a id="l00600" name="l00600"></a><span class="lineno">  600</span>  <span class="keyword">friend</span> <span class="keyword">class </span>TestSuite;</div>
<div class="line"><a id="l00601" name="l00601"></a><span class="lineno">  601</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::UnitTestImpl;</div>
<div class="line"><a id="l00602" name="l00602"></a><span class="lineno">  602</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::StreamingListenerTest;</div>
<div class="line"><a id="l00603" name="l00603"></a><span class="lineno">  603</span>  <span class="keyword">friend</span> TestInfo* internal::MakeAndRegisterTestInfo(</div>
<div class="line"><a id="l00604" name="l00604"></a><span class="lineno">  604</span>      <span class="keyword">const</span> <span class="keywordtype">char</span>* test_suite_name, <span class="keyword">const</span> <span class="keywordtype">char</span>* name, <span class="keyword">const</span> <span class="keywordtype">char</span>* type_param,</div>
<div class="line"><a id="l00605" name="l00605"></a><span class="lineno">  605</span>      <span class="keyword">const</span> <span class="keywordtype">char</span>* value_param, internal::CodeLocation code_location,</div>
<div class="line"><a id="l00606" name="l00606"></a><span class="lineno">  606</span>      internal::TypeId fixture_class_id, internal::SetUpTestSuiteFunc set_up_tc,</div>
<div class="line"><a id="l00607" name="l00607"></a><span class="lineno">  607</span>      internal::TearDownTestSuiteFunc tear_down_tc,</div>
<div class="line"><a id="l00608" name="l00608"></a><span class="lineno">  608</span>      internal::TestFactoryBase* factory);</div>
<div class="line"><a id="l00609" name="l00609"></a><span class="lineno">  609</span> </div>
<div class="line"><a id="l00610" name="l00610"></a><span class="lineno">  610</span>  <span class="comment">// Constructs a TestInfo object. The newly constructed instance assumes</span></div>
<div class="line"><a id="l00611" name="l00611"></a><span class="lineno">  611</span>  <span class="comment">// ownership of the factory object.</span></div>
<div class="line"><a id="l00612" name="l00612"></a><span class="lineno">  612</span>  TestInfo(<span class="keyword">const</span> std::string&amp; test_suite_name, <span class="keyword">const</span> std::string&amp; name,</div>
<div class="line"><a id="l00613" name="l00613"></a><span class="lineno">  613</span>           <span class="keyword">const</span> <span class="keywordtype">char</span>* a_type_param,   <span class="comment">// NULL if not a type-parameterized test</span></div>
<div class="line"><a id="l00614" name="l00614"></a><span class="lineno">  614</span>           <span class="keyword">const</span> <span class="keywordtype">char</span>* a_value_param,  <span class="comment">// NULL if not a value-parameterized test</span></div>
<div class="line"><a id="l00615" name="l00615"></a><span class="lineno">  615</span>           internal::CodeLocation a_code_location,</div>
<div class="line"><a id="l00616" name="l00616"></a><span class="lineno">  616</span>           internal::TypeId fixture_class_id,</div>
<div class="line"><a id="l00617" name="l00617"></a><span class="lineno">  617</span>           internal::TestFactoryBase* factory);</div>
<div class="line"><a id="l00618" name="l00618"></a><span class="lineno">  618</span> </div>
<div class="line"><a id="l00619" name="l00619"></a><span class="lineno">  619</span>  <span class="comment">// Increments the number of death tests encountered in this test so</span></div>
<div class="line"><a id="l00620" name="l00620"></a><span class="lineno">  620</span>  <span class="comment">// far.</span></div>
<div class="line"><a id="l00621" name="l00621"></a><span class="lineno">  621</span>  <span class="keywordtype">int</span> increment_death_test_count() {</div>
<div class="line"><a id="l00622" name="l00622"></a><span class="lineno">  622</span>    <span class="keywordflow">return</span> result_.increment_death_test_count();</div>
<div class="line"><a id="l00623" name="l00623"></a><span class="lineno">  623</span>  }</div>
<div class="line"><a id="l00624" name="l00624"></a><span class="lineno">  624</span> </div>
<div class="line"><a id="l00625" name="l00625"></a><span class="lineno">  625</span>  <span class="comment">// Creates the test object, runs it, records its result, and then</span></div>
<div class="line"><a id="l00626" name="l00626"></a><span class="lineno">  626</span>  <span class="comment">// deletes it.</span></div>
<div class="line"><a id="l00627" name="l00627"></a><span class="lineno">  627</span>  <span class="keywordtype">void</span> Run();</div>
<div class="line"><a id="l00628" name="l00628"></a><span class="lineno">  628</span> </div>
<div class="line"><a id="l00629" name="l00629"></a><span class="lineno">  629</span>  <span class="comment">// Skip and records the test result for this object.</span></div>
<div class="line"><a id="l00630" name="l00630"></a><span class="lineno">  630</span>  <span class="keywordtype">void</span> Skip();</div>
<div class="line"><a id="l00631" name="l00631"></a><span class="lineno">  631</span> </div>
<div class="line"><a id="l00632" name="l00632"></a><span class="lineno">  632</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> ClearTestResult(TestInfo* test_info) {</div>
<div class="line"><a id="l00633" name="l00633"></a><span class="lineno">  633</span>    test_info-&gt;result_.Clear();</div>
<div class="line"><a id="l00634" name="l00634"></a><span class="lineno">  634</span>  }</div>
<div class="line"><a id="l00635" name="l00635"></a><span class="lineno">  635</span> </div>
<div class="line"><a id="l00636" name="l00636"></a><span class="lineno">  636</span>  <span class="comment">// These fields are immutable properties of the test.</span></div>
<div class="line"><a id="l00637" name="l00637"></a><span class="lineno">  637</span>  <span class="keyword">const</span> std::string test_suite_name_;  <span class="comment">// test suite name</span></div>
<div class="line"><a id="l00638" name="l00638"></a><span class="lineno">  638</span>  <span class="keyword">const</span> std::string name_;             <span class="comment">// Test name</span></div>
<div class="line"><a id="l00639" name="l00639"></a><span class="lineno">  639</span>  <span class="comment">// Name of the parameter type, or NULL if this is not a typed or a</span></div>
<div class="line"><a id="l00640" name="l00640"></a><span class="lineno">  640</span>  <span class="comment">// type-parameterized test.</span></div>
<div class="line"><a id="l00641" name="l00641"></a><span class="lineno">  641</span>  <span class="keyword">const</span> std::unique_ptr&lt;const ::std::string&gt; type_param_;</div>
<div class="line"><a id="l00642" name="l00642"></a><span class="lineno">  642</span>  <span class="comment">// Text representation of the value parameter, or NULL if this is not a</span></div>
<div class="line"><a id="l00643" name="l00643"></a><span class="lineno">  643</span>  <span class="comment">// value-parameterized test.</span></div>
<div class="line"><a id="l00644" name="l00644"></a><span class="lineno">  644</span>  <span class="keyword">const</span> std::unique_ptr&lt;const ::std::string&gt; value_param_;</div>
<div class="line"><a id="l00645" name="l00645"></a><span class="lineno">  645</span>  internal::CodeLocation location_;</div>
<div class="line"><a id="l00646" name="l00646"></a><span class="lineno">  646</span>  <span class="keyword">const</span> internal::TypeId fixture_class_id_;  <span class="comment">// ID of the test fixture class</span></div>
<div class="line"><a id="l00647" name="l00647"></a><span class="lineno">  647</span>  <span class="keywordtype">bool</span> should_run_;           <span class="comment">// True if and only if this test should run</span></div>
<div class="line"><a id="l00648" name="l00648"></a><span class="lineno">  648</span>  <span class="keywordtype">bool</span> is_disabled_;          <span class="comment">// True if and only if this test is disabled</span></div>
<div class="line"><a id="l00649" name="l00649"></a><span class="lineno">  649</span>  <span class="keywordtype">bool</span> matches_filter_;       <span class="comment">// True if this test matches the</span></div>
<div class="line"><a id="l00650" name="l00650"></a><span class="lineno">  650</span>                              <span class="comment">// user-specified filter.</span></div>
<div class="line"><a id="l00651" name="l00651"></a><span class="lineno">  651</span>  <span class="keywordtype">bool</span> is_in_another_shard_;  <span class="comment">// Will be run in another shard.</span></div>
<div class="line"><a id="l00652" name="l00652"></a><span class="lineno">  652</span>  internal::TestFactoryBase* <span class="keyword">const</span> factory_;  <span class="comment">// The factory that creates</span></div>
<div class="line"><a id="l00653" name="l00653"></a><span class="lineno">  653</span>                                              <span class="comment">// the test object</span></div>
<div class="line"><a id="l00654" name="l00654"></a><span class="lineno">  654</span> </div>
<div class="line"><a id="l00655" name="l00655"></a><span class="lineno">  655</span>  <span class="comment">// This field is mutable and needs to be reset before running the</span></div>
<div class="line"><a id="l00656" name="l00656"></a><span class="lineno">  656</span>  <span class="comment">// test for the second time.</span></div>
<div class="line"><a id="l00657" name="l00657"></a><span class="lineno">  657</span>  <a class="code hl_class" href="class_test_result.html">TestResult</a> result_;</div>
<div class="line"><a id="l00658" name="l00658"></a><span class="lineno">  658</span> </div>
<div class="line"><a id="l00659" name="l00659"></a><span class="lineno">  659</span>  TestInfo(<span class="keyword">const</span> TestInfo&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00660" name="l00660"></a><span class="lineno">  660</span>  TestInfo&amp; operator=(<span class="keyword">const</span> TestInfo&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00661" name="l00661"></a><span class="lineno">  661</span>};</div>
</div>
<div class="line"><a id="l00662" name="l00662"></a><span class="lineno">  662</span> </div>
<div class="line"><a id="l00663" name="l00663"></a><span class="lineno">  663</span><span class="comment">// A test suite, which consists of a vector of TestInfos.</span></div>
<div class="line"><a id="l00664" name="l00664"></a><span class="lineno">  664</span><span class="comment">//</span></div>
<div class="line"><a id="l00665" name="l00665"></a><span class="lineno">  665</span><span class="comment">// TestSuite is not copyable.</span></div>
<div class="foldopen" id="foldopen00666" data-start="{" data-end="};">
<div class="line"><a id="l00666" name="l00666"></a><span class="lineno"><a class="line" href="classtesting_1_1_test_suite.html">  666</a></span><span class="keyword">class </span>GTEST_API_ TestSuite {</div>
<div class="line"><a id="l00667" name="l00667"></a><span class="lineno">  667</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00668" name="l00668"></a><span class="lineno">  668</span>  <span class="comment">// Creates a TestSuite with the given name.</span></div>
<div class="line"><a id="l00669" name="l00669"></a><span class="lineno">  669</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00670" name="l00670"></a><span class="lineno">  670</span>  <span class="comment">// TestSuite does NOT have a default constructor.  Always use this</span></div>
<div class="line"><a id="l00671" name="l00671"></a><span class="lineno">  671</span>  <span class="comment">// constructor to create a TestSuite object.</span></div>
<div class="line"><a id="l00672" name="l00672"></a><span class="lineno">  672</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00673" name="l00673"></a><span class="lineno">  673</span>  <span class="comment">// Arguments:</span></div>
<div class="line"><a id="l00674" name="l00674"></a><span class="lineno">  674</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00675" name="l00675"></a><span class="lineno">  675</span>  <span class="comment">//   name:         name of the test suite</span></div>
<div class="line"><a id="l00676" name="l00676"></a><span class="lineno">  676</span>  <span class="comment">//   a_type_param: the name of the test&#39;s type parameter, or NULL if</span></div>
<div class="line"><a id="l00677" name="l00677"></a><span class="lineno">  677</span>  <span class="comment">//                 this is not a type-parameterized test.</span></div>
<div class="line"><a id="l00678" name="l00678"></a><span class="lineno">  678</span>  <span class="comment">//   set_up_tc:    pointer to the function that sets up the test suite</span></div>
<div class="line"><a id="l00679" name="l00679"></a><span class="lineno">  679</span>  <span class="comment">//   tear_down_tc: pointer to the function that tears down the test suite</span></div>
<div class="line"><a id="l00680" name="l00680"></a><span class="lineno">  680</span>  TestSuite(<span class="keyword">const</span> <span class="keywordtype">char</span>* name, <span class="keyword">const</span> <span class="keywordtype">char</span>* a_type_param,</div>
<div class="line"><a id="l00681" name="l00681"></a><span class="lineno">  681</span>            internal::SetUpTestSuiteFunc set_up_tc,</div>
<div class="line"><a id="l00682" name="l00682"></a><span class="lineno">  682</span>            internal::TearDownTestSuiteFunc tear_down_tc);</div>
<div class="line"><a id="l00683" name="l00683"></a><span class="lineno">  683</span> </div>
<div class="line"><a id="l00684" name="l00684"></a><span class="lineno">  684</span>  <span class="comment">// Destructor of TestSuite.</span></div>
<div class="line"><a id="l00685" name="l00685"></a><span class="lineno">  685</span>  <span class="keyword">virtual</span> ~TestSuite();</div>
<div class="line"><a id="l00686" name="l00686"></a><span class="lineno">  686</span> </div>
<div class="line"><a id="l00687" name="l00687"></a><span class="lineno">  687</span>  <span class="comment">// Gets the name of the TestSuite.</span></div>
<div class="line"><a id="l00688" name="l00688"></a><span class="lineno">  688</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* name()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> name_.c_str(); }</div>
<div class="line"><a id="l00689" name="l00689"></a><span class="lineno">  689</span> </div>
<div class="line"><a id="l00690" name="l00690"></a><span class="lineno">  690</span>  <span class="comment">// Returns the name of the parameter type, or NULL if this is not a</span></div>
<div class="line"><a id="l00691" name="l00691"></a><span class="lineno">  691</span>  <span class="comment">// type-parameterized test suite.</span></div>
<div class="line"><a id="l00692" name="l00692"></a><span class="lineno">  692</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* type_param()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00693" name="l00693"></a><span class="lineno">  693</span>    <span class="keywordflow">if</span> (type_param_.get() != <span class="keyword">nullptr</span>) <span class="keywordflow">return</span> type_param_-&gt;c_str();</div>
<div class="line"><a id="l00694" name="l00694"></a><span class="lineno">  694</span>    <span class="keywordflow">return</span> <span class="keyword">nullptr</span>;</div>
<div class="line"><a id="l00695" name="l00695"></a><span class="lineno">  695</span>  }</div>
<div class="line"><a id="l00696" name="l00696"></a><span class="lineno">  696</span> </div>
<div class="line"><a id="l00697" name="l00697"></a><span class="lineno">  697</span>  <span class="comment">// Returns true if any test in this test suite should run.</span></div>
<div class="line"><a id="l00698" name="l00698"></a><span class="lineno">  698</span>  <span class="keywordtype">bool</span> should_run()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> should_run_; }</div>
<div class="line"><a id="l00699" name="l00699"></a><span class="lineno">  699</span> </div>
<div class="line"><a id="l00700" name="l00700"></a><span class="lineno">  700</span>  <span class="comment">// Gets the number of successful tests in this test suite.</span></div>
<div class="line"><a id="l00701" name="l00701"></a><span class="lineno">  701</span>  <span class="keywordtype">int</span> successful_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00702" name="l00702"></a><span class="lineno">  702</span> </div>
<div class="line"><a id="l00703" name="l00703"></a><span class="lineno">  703</span>  <span class="comment">// Gets the number of skipped tests in this test suite.</span></div>
<div class="line"><a id="l00704" name="l00704"></a><span class="lineno">  704</span>  <span class="keywordtype">int</span> skipped_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00705" name="l00705"></a><span class="lineno">  705</span> </div>
<div class="line"><a id="l00706" name="l00706"></a><span class="lineno">  706</span>  <span class="comment">// Gets the number of failed tests in this test suite.</span></div>
<div class="line"><a id="l00707" name="l00707"></a><span class="lineno">  707</span>  <span class="keywordtype">int</span> failed_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00708" name="l00708"></a><span class="lineno">  708</span> </div>
<div class="line"><a id="l00709" name="l00709"></a><span class="lineno">  709</span>  <span class="comment">// Gets the number of disabled tests that will be reported in the XML report.</span></div>
<div class="line"><a id="l00710" name="l00710"></a><span class="lineno">  710</span>  <span class="keywordtype">int</span> reportable_disabled_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00711" name="l00711"></a><span class="lineno">  711</span> </div>
<div class="line"><a id="l00712" name="l00712"></a><span class="lineno">  712</span>  <span class="comment">// Gets the number of disabled tests in this test suite.</span></div>
<div class="line"><a id="l00713" name="l00713"></a><span class="lineno">  713</span>  <span class="keywordtype">int</span> disabled_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00714" name="l00714"></a><span class="lineno">  714</span> </div>
<div class="line"><a id="l00715" name="l00715"></a><span class="lineno">  715</span>  <span class="comment">// Gets the number of tests to be printed in the XML report.</span></div>
<div class="line"><a id="l00716" name="l00716"></a><span class="lineno">  716</span>  <span class="keywordtype">int</span> reportable_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00717" name="l00717"></a><span class="lineno">  717</span> </div>
<div class="line"><a id="l00718" name="l00718"></a><span class="lineno">  718</span>  <span class="comment">// Get the number of tests in this test suite that should run.</span></div>
<div class="line"><a id="l00719" name="l00719"></a><span class="lineno">  719</span>  <span class="keywordtype">int</span> test_to_run_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00720" name="l00720"></a><span class="lineno">  720</span> </div>
<div class="line"><a id="l00721" name="l00721"></a><span class="lineno">  721</span>  <span class="comment">// Gets the number of all tests in this test suite.</span></div>
<div class="line"><a id="l00722" name="l00722"></a><span class="lineno">  722</span>  <span class="keywordtype">int</span> total_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l00723" name="l00723"></a><span class="lineno">  723</span> </div>
<div class="line"><a id="l00724" name="l00724"></a><span class="lineno">  724</span>  <span class="comment">// Returns true if and only if the test suite passed.</span></div>
<div class="line"><a id="l00725" name="l00725"></a><span class="lineno">  725</span>  <span class="keywordtype">bool</span> Passed()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> !Failed(); }</div>
<div class="line"><a id="l00726" name="l00726"></a><span class="lineno">  726</span> </div>
<div class="line"><a id="l00727" name="l00727"></a><span class="lineno">  727</span>  <span class="comment">// Returns true if and only if the test suite failed.</span></div>
<div class="line"><a id="l00728" name="l00728"></a><span class="lineno">  728</span>  <span class="keywordtype">bool</span> Failed()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00729" name="l00729"></a><span class="lineno">  729</span>    <span class="keywordflow">return</span> failed_test_count() &gt; 0 || ad_hoc_test_result().Failed();</div>
<div class="line"><a id="l00730" name="l00730"></a><span class="lineno">  730</span>  }</div>
<div class="line"><a id="l00731" name="l00731"></a><span class="lineno">  731</span> </div>
<div class="line"><a id="l00732" name="l00732"></a><span class="lineno">  732</span>  <span class="comment">// Returns the elapsed time, in milliseconds.</span></div>
<div class="line"><a id="l00733" name="l00733"></a><span class="lineno">  733</span>  TimeInMillis elapsed_time()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> elapsed_time_; }</div>
<div class="line"><a id="l00734" name="l00734"></a><span class="lineno">  734</span> </div>
<div class="line"><a id="l00735" name="l00735"></a><span class="lineno">  735</span>  <span class="comment">// Gets the time of the test suite start, in ms from the start of the</span></div>
<div class="line"><a id="l00736" name="l00736"></a><span class="lineno">  736</span>  <span class="comment">// UNIX epoch.</span></div>
<div class="line"><a id="l00737" name="l00737"></a><span class="lineno">  737</span>  TimeInMillis start_timestamp()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> start_timestamp_; }</div>
<div class="line"><a id="l00738" name="l00738"></a><span class="lineno">  738</span> </div>
<div class="line"><a id="l00739" name="l00739"></a><span class="lineno">  739</span>  <span class="comment">// Returns the i-th test among all the tests. i can range from 0 to</span></div>
<div class="line"><a id="l00740" name="l00740"></a><span class="lineno">  740</span>  <span class="comment">// total_test_count() - 1. If i is not in that range, returns NULL.</span></div>
<div class="line"><a id="l00741" name="l00741"></a><span class="lineno">  741</span>  <span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>* GetTestInfo(<span class="keywordtype">int</span> i) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00742" name="l00742"></a><span class="lineno">  742</span> </div>
<div class="line"><a id="l00743" name="l00743"></a><span class="lineno">  743</span>  <span class="comment">// Returns the TestResult that holds test properties recorded during</span></div>
<div class="line"><a id="l00744" name="l00744"></a><span class="lineno">  744</span>  <span class="comment">// execution of SetUpTestSuite and TearDownTestSuite.</span></div>
<div class="line"><a id="l00745" name="l00745"></a><span class="lineno">  745</span>  <span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_result.html">TestResult</a>&amp; ad_hoc_test_result()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> ad_hoc_test_result_; }</div>
<div class="line"><a id="l00746" name="l00746"></a><span class="lineno">  746</span> </div>
<div class="line"><a id="l00747" name="l00747"></a><span class="lineno">  747</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00748" name="l00748"></a><span class="lineno">  748</span>  <span class="keyword">friend</span> <span class="keyword">class </span>Test;</div>
<div class="line"><a id="l00749" name="l00749"></a><span class="lineno">  749</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_unit_test_impl.html">internal::UnitTestImpl</a>;</div>
<div class="line"><a id="l00750" name="l00750"></a><span class="lineno">  750</span> </div>
<div class="line"><a id="l00751" name="l00751"></a><span class="lineno">  751</span>  <span class="comment">// Gets the (mutable) vector of TestInfos in this TestSuite.</span></div>
<div class="line"><a id="l00752" name="l00752"></a><span class="lineno">  752</span>  std::vector&lt;TestInfo*&gt;&amp; test_info_list() { <span class="keywordflow">return</span> test_info_list_; }</div>
<div class="line"><a id="l00753" name="l00753"></a><span class="lineno">  753</span> </div>
<div class="line"><a id="l00754" name="l00754"></a><span class="lineno">  754</span>  <span class="comment">// Gets the (immutable) vector of TestInfos in this TestSuite.</span></div>
<div class="line"><a id="l00755" name="l00755"></a><span class="lineno">  755</span>  <span class="keyword">const</span> std::vector&lt;TestInfo*&gt;&amp; test_info_list()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00756" name="l00756"></a><span class="lineno">  756</span>    <span class="keywordflow">return</span> test_info_list_;</div>
<div class="line"><a id="l00757" name="l00757"></a><span class="lineno">  757</span>  }</div>
<div class="line"><a id="l00758" name="l00758"></a><span class="lineno">  758</span> </div>
<div class="line"><a id="l00759" name="l00759"></a><span class="lineno">  759</span>  <span class="comment">// Returns the i-th test among all the tests. i can range from 0 to</span></div>
<div class="line"><a id="l00760" name="l00760"></a><span class="lineno">  760</span>  <span class="comment">// total_test_count() - 1. If i is not in that range, returns NULL.</span></div>
<div class="line"><a id="l00761" name="l00761"></a><span class="lineno">  761</span>  <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>* GetMutableTestInfo(<span class="keywordtype">int</span> i);</div>
<div class="line"><a id="l00762" name="l00762"></a><span class="lineno">  762</span> </div>
<div class="line"><a id="l00763" name="l00763"></a><span class="lineno">  763</span>  <span class="comment">// Sets the should_run member.</span></div>
<div class="line"><a id="l00764" name="l00764"></a><span class="lineno">  764</span>  <span class="keywordtype">void</span> set_should_run(<span class="keywordtype">bool</span> should) { should_run_ = should; }</div>
<div class="line"><a id="l00765" name="l00765"></a><span class="lineno">  765</span> </div>
<div class="line"><a id="l00766" name="l00766"></a><span class="lineno">  766</span>  <span class="comment">// Adds a TestInfo to this test suite.  Will delete the TestInfo upon</span></div>
<div class="line"><a id="l00767" name="l00767"></a><span class="lineno">  767</span>  <span class="comment">// destruction of the TestSuite object.</span></div>
<div class="line"><a id="l00768" name="l00768"></a><span class="lineno">  768</span>  <span class="keywordtype">void</span> AddTestInfo(<a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>* test_info);</div>
<div class="line"><a id="l00769" name="l00769"></a><span class="lineno">  769</span> </div>
<div class="line"><a id="l00770" name="l00770"></a><span class="lineno">  770</span>  <span class="comment">// Clears the results of all tests in this test suite.</span></div>
<div class="line"><a id="l00771" name="l00771"></a><span class="lineno">  771</span>  <span class="keywordtype">void</span> ClearResult();</div>
<div class="line"><a id="l00772" name="l00772"></a><span class="lineno">  772</span> </div>
<div class="line"><a id="l00773" name="l00773"></a><span class="lineno">  773</span>  <span class="comment">// Clears the results of all tests in the given test suite.</span></div>
<div class="line"><a id="l00774" name="l00774"></a><span class="lineno">  774</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> ClearTestSuiteResult(TestSuite* test_suite) {</div>
<div class="line"><a id="l00775" name="l00775"></a><span class="lineno">  775</span>    test_suite-&gt;ClearResult();</div>
<div class="line"><a id="l00776" name="l00776"></a><span class="lineno">  776</span>  }</div>
<div class="line"><a id="l00777" name="l00777"></a><span class="lineno">  777</span> </div>
<div class="line"><a id="l00778" name="l00778"></a><span class="lineno">  778</span>  <span class="comment">// Runs every test in this TestSuite.</span></div>
<div class="line"><a id="l00779" name="l00779"></a><span class="lineno">  779</span>  <span class="keywordtype">void</span> Run();</div>
<div class="line"><a id="l00780" name="l00780"></a><span class="lineno">  780</span> </div>
<div class="line"><a id="l00781" name="l00781"></a><span class="lineno">  781</span>  <span class="comment">// Skips the execution of tests under this TestSuite</span></div>
<div class="line"><a id="l00782" name="l00782"></a><span class="lineno">  782</span>  <span class="keywordtype">void</span> Skip();</div>
<div class="line"><a id="l00783" name="l00783"></a><span class="lineno">  783</span> </div>
<div class="line"><a id="l00784" name="l00784"></a><span class="lineno">  784</span>  <span class="comment">// Runs SetUpTestSuite() for this TestSuite.  This wrapper is needed</span></div>
<div class="line"><a id="l00785" name="l00785"></a><span class="lineno">  785</span>  <span class="comment">// for catching exceptions thrown from SetUpTestSuite().</span></div>
<div class="line"><a id="l00786" name="l00786"></a><span class="lineno">  786</span>  <span class="keywordtype">void</span> RunSetUpTestSuite() {</div>
<div class="line"><a id="l00787" name="l00787"></a><span class="lineno">  787</span>    <span class="keywordflow">if</span> (set_up_tc_ != <span class="keyword">nullptr</span>) {</div>
<div class="line"><a id="l00788" name="l00788"></a><span class="lineno">  788</span>      (*set_up_tc_)();</div>
<div class="line"><a id="l00789" name="l00789"></a><span class="lineno">  789</span>    }</div>
<div class="line"><a id="l00790" name="l00790"></a><span class="lineno">  790</span>  }</div>
<div class="line"><a id="l00791" name="l00791"></a><span class="lineno">  791</span> </div>
<div class="line"><a id="l00792" name="l00792"></a><span class="lineno">  792</span>  <span class="comment">// Runs TearDownTestSuite() for this TestSuite.  This wrapper is</span></div>
<div class="line"><a id="l00793" name="l00793"></a><span class="lineno">  793</span>  <span class="comment">// needed for catching exceptions thrown from TearDownTestSuite().</span></div>
<div class="line"><a id="l00794" name="l00794"></a><span class="lineno">  794</span>  <span class="keywordtype">void</span> RunTearDownTestSuite() {</div>
<div class="line"><a id="l00795" name="l00795"></a><span class="lineno">  795</span>    <span class="keywordflow">if</span> (tear_down_tc_ != <span class="keyword">nullptr</span>) {</div>
<div class="line"><a id="l00796" name="l00796"></a><span class="lineno">  796</span>      (*tear_down_tc_)();</div>
<div class="line"><a id="l00797" name="l00797"></a><span class="lineno">  797</span>    }</div>
<div class="line"><a id="l00798" name="l00798"></a><span class="lineno">  798</span>  }</div>
<div class="line"><a id="l00799" name="l00799"></a><span class="lineno">  799</span> </div>
<div class="line"><a id="l00800" name="l00800"></a><span class="lineno">  800</span>  <span class="comment">// Returns true if and only if test passed.</span></div>
<div class="line"><a id="l00801" name="l00801"></a><span class="lineno">  801</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> TestPassed(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>* test_info) {</div>
<div class="line"><a id="l00802" name="l00802"></a><span class="lineno">  802</span>    <span class="keywordflow">return</span> test_info-&gt;should_run() &amp;&amp; test_info-&gt;result()-&gt;Passed();</div>
<div class="line"><a id="l00803" name="l00803"></a><span class="lineno">  803</span>  }</div>
<div class="line"><a id="l00804" name="l00804"></a><span class="lineno">  804</span> </div>
<div class="line"><a id="l00805" name="l00805"></a><span class="lineno">  805</span>  <span class="comment">// Returns true if and only if test skipped.</span></div>
<div class="line"><a id="l00806" name="l00806"></a><span class="lineno">  806</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> TestSkipped(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>* test_info) {</div>
<div class="line"><a id="l00807" name="l00807"></a><span class="lineno">  807</span>    <span class="keywordflow">return</span> test_info-&gt;should_run() &amp;&amp; test_info-&gt;result()-&gt;Skipped();</div>
<div class="line"><a id="l00808" name="l00808"></a><span class="lineno">  808</span>  }</div>
<div class="line"><a id="l00809" name="l00809"></a><span class="lineno">  809</span> </div>
<div class="line"><a id="l00810" name="l00810"></a><span class="lineno">  810</span>  <span class="comment">// Returns true if and only if test failed.</span></div>
<div class="line"><a id="l00811" name="l00811"></a><span class="lineno">  811</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> TestFailed(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>* test_info) {</div>
<div class="line"><a id="l00812" name="l00812"></a><span class="lineno">  812</span>    <span class="keywordflow">return</span> test_info-&gt;should_run() &amp;&amp; test_info-&gt;result()-&gt;Failed();</div>
<div class="line"><a id="l00813" name="l00813"></a><span class="lineno">  813</span>  }</div>
<div class="line"><a id="l00814" name="l00814"></a><span class="lineno">  814</span> </div>
<div class="line"><a id="l00815" name="l00815"></a><span class="lineno">  815</span>  <span class="comment">// Returns true if and only if the test is disabled and will be reported in</span></div>
<div class="line"><a id="l00816" name="l00816"></a><span class="lineno">  816</span>  <span class="comment">// the XML report.</span></div>
<div class="line"><a id="l00817" name="l00817"></a><span class="lineno">  817</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> TestReportableDisabled(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>* test_info) {</div>
<div class="line"><a id="l00818" name="l00818"></a><span class="lineno">  818</span>    <span class="keywordflow">return</span> test_info-&gt;is_reportable() &amp;&amp; test_info-&gt;is_disabled_;</div>
<div class="line"><a id="l00819" name="l00819"></a><span class="lineno">  819</span>  }</div>
<div class="line"><a id="l00820" name="l00820"></a><span class="lineno">  820</span> </div>
<div class="line"><a id="l00821" name="l00821"></a><span class="lineno">  821</span>  <span class="comment">// Returns true if and only if test is disabled.</span></div>
<div class="line"><a id="l00822" name="l00822"></a><span class="lineno">  822</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> TestDisabled(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>* test_info) {</div>
<div class="line"><a id="l00823" name="l00823"></a><span class="lineno">  823</span>    <span class="keywordflow">return</span> test_info-&gt;is_disabled_;</div>
<div class="line"><a id="l00824" name="l00824"></a><span class="lineno">  824</span>  }</div>
<div class="line"><a id="l00825" name="l00825"></a><span class="lineno">  825</span> </div>
<div class="line"><a id="l00826" name="l00826"></a><span class="lineno">  826</span>  <span class="comment">// Returns true if and only if this test will appear in the XML report.</span></div>
<div class="line"><a id="l00827" name="l00827"></a><span class="lineno">  827</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> TestReportable(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>* test_info) {</div>
<div class="line"><a id="l00828" name="l00828"></a><span class="lineno">  828</span>    <span class="keywordflow">return</span> test_info-&gt;is_reportable();</div>
<div class="line"><a id="l00829" name="l00829"></a><span class="lineno">  829</span>  }</div>
<div class="line"><a id="l00830" name="l00830"></a><span class="lineno">  830</span> </div>
<div class="line"><a id="l00831" name="l00831"></a><span class="lineno">  831</span>  <span class="comment">// Returns true if the given test should run.</span></div>
<div class="line"><a id="l00832" name="l00832"></a><span class="lineno">  832</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> ShouldRunTest(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>* test_info) {</div>
<div class="line"><a id="l00833" name="l00833"></a><span class="lineno">  833</span>    <span class="keywordflow">return</span> test_info-&gt;should_run();</div>
<div class="line"><a id="l00834" name="l00834"></a><span class="lineno">  834</span>  }</div>
<div class="line"><a id="l00835" name="l00835"></a><span class="lineno">  835</span> </div>
<div class="line"><a id="l00836" name="l00836"></a><span class="lineno">  836</span>  <span class="comment">// Shuffles the tests in this test suite.</span></div>
<div class="line"><a id="l00837" name="l00837"></a><span class="lineno">  837</span>  <span class="keywordtype">void</span> ShuffleTests(<a class="code hl_class" href="classtesting_1_1internal_1_1_random.html">internal::Random</a>* random);</div>
<div class="line"><a id="l00838" name="l00838"></a><span class="lineno">  838</span> </div>
<div class="line"><a id="l00839" name="l00839"></a><span class="lineno">  839</span>  <span class="comment">// Restores the test order to before the first shuffle.</span></div>
<div class="line"><a id="l00840" name="l00840"></a><span class="lineno">  840</span>  <span class="keywordtype">void</span> UnshuffleTests();</div>
<div class="line"><a id="l00841" name="l00841"></a><span class="lineno">  841</span> </div>
<div class="line"><a id="l00842" name="l00842"></a><span class="lineno">  842</span>  <span class="comment">// Name of the test suite.</span></div>
<div class="line"><a id="l00843" name="l00843"></a><span class="lineno">  843</span>  std::string name_;</div>
<div class="line"><a id="l00844" name="l00844"></a><span class="lineno">  844</span>  <span class="comment">// Name of the parameter type, or NULL if this is not a typed or a</span></div>
<div class="line"><a id="l00845" name="l00845"></a><span class="lineno">  845</span>  <span class="comment">// type-parameterized test.</span></div>
<div class="line"><a id="l00846" name="l00846"></a><span class="lineno">  846</span>  <span class="keyword">const</span> std::unique_ptr&lt;const ::std::string&gt; type_param_;</div>
<div class="line"><a id="l00847" name="l00847"></a><span class="lineno">  847</span>  <span class="comment">// The vector of TestInfos in their original order.  It owns the</span></div>
<div class="line"><a id="l00848" name="l00848"></a><span class="lineno">  848</span>  <span class="comment">// elements in the vector.</span></div>
<div class="line"><a id="l00849" name="l00849"></a><span class="lineno">  849</span>  std::vector&lt;TestInfo*&gt; test_info_list_;</div>
<div class="line"><a id="l00850" name="l00850"></a><span class="lineno">  850</span>  <span class="comment">// Provides a level of indirection for the test list to allow easy</span></div>
<div class="line"><a id="l00851" name="l00851"></a><span class="lineno">  851</span>  <span class="comment">// shuffling and restoring the test order.  The i-th element in this</span></div>
<div class="line"><a id="l00852" name="l00852"></a><span class="lineno">  852</span>  <span class="comment">// vector is the index of the i-th test in the shuffled test list.</span></div>
<div class="line"><a id="l00853" name="l00853"></a><span class="lineno">  853</span>  std::vector&lt;int&gt; test_indices_;</div>
<div class="line"><a id="l00854" name="l00854"></a><span class="lineno">  854</span>  <span class="comment">// Pointer to the function that sets up the test suite.</span></div>
<div class="line"><a id="l00855" name="l00855"></a><span class="lineno">  855</span>  internal::SetUpTestSuiteFunc set_up_tc_;</div>
<div class="line"><a id="l00856" name="l00856"></a><span class="lineno">  856</span>  <span class="comment">// Pointer to the function that tears down the test suite.</span></div>
<div class="line"><a id="l00857" name="l00857"></a><span class="lineno">  857</span>  internal::TearDownTestSuiteFunc tear_down_tc_;</div>
<div class="line"><a id="l00858" name="l00858"></a><span class="lineno">  858</span>  <span class="comment">// True if and only if any test in this test suite should run.</span></div>
<div class="line"><a id="l00859" name="l00859"></a><span class="lineno">  859</span>  <span class="keywordtype">bool</span> should_run_;</div>
<div class="line"><a id="l00860" name="l00860"></a><span class="lineno">  860</span>  <span class="comment">// The start time, in milliseconds since UNIX Epoch.</span></div>
<div class="line"><a id="l00861" name="l00861"></a><span class="lineno">  861</span>  TimeInMillis start_timestamp_;</div>
<div class="line"><a id="l00862" name="l00862"></a><span class="lineno">  862</span>  <span class="comment">// Elapsed time, in milliseconds.</span></div>
<div class="line"><a id="l00863" name="l00863"></a><span class="lineno">  863</span>  TimeInMillis elapsed_time_;</div>
<div class="line"><a id="l00864" name="l00864"></a><span class="lineno">  864</span>  <span class="comment">// Holds test properties recorded during execution of SetUpTestSuite and</span></div>
<div class="line"><a id="l00865" name="l00865"></a><span class="lineno">  865</span>  <span class="comment">// TearDownTestSuite.</span></div>
<div class="line"><a id="l00866" name="l00866"></a><span class="lineno">  866</span>  <a class="code hl_class" href="classtesting_1_1_test_result.html">TestResult</a> ad_hoc_test_result_;</div>
<div class="line"><a id="l00867" name="l00867"></a><span class="lineno">  867</span> </div>
<div class="line"><a id="l00868" name="l00868"></a><span class="lineno">  868</span>  <span class="comment">// We disallow copying TestSuites.</span></div>
<div class="line"><a id="l00869" name="l00869"></a><span class="lineno">  869</span>  TestSuite(<span class="keyword">const</span> TestSuite&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00870" name="l00870"></a><span class="lineno">  870</span>  TestSuite&amp; operator=(<span class="keyword">const</span> TestSuite&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00871" name="l00871"></a><span class="lineno">  871</span>};</div>
</div>
<div class="line"><a id="l00872" name="l00872"></a><span class="lineno">  872</span> </div>
<div class="line"><a id="l00873" name="l00873"></a><span class="lineno">  873</span><span class="comment">// An Environment object is capable of setting up and tearing down an</span></div>
<div class="line"><a id="l00874" name="l00874"></a><span class="lineno">  874</span><span class="comment">// environment.  You should subclass this to define your own</span></div>
<div class="line"><a id="l00875" name="l00875"></a><span class="lineno">  875</span><span class="comment">// environment(s).</span></div>
<div class="line"><a id="l00876" name="l00876"></a><span class="lineno">  876</span><span class="comment">//</span></div>
<div class="line"><a id="l00877" name="l00877"></a><span class="lineno">  877</span><span class="comment">// An Environment object does the set-up and tear-down in virtual</span></div>
<div class="line"><a id="l00878" name="l00878"></a><span class="lineno">  878</span><span class="comment">// methods SetUp() and TearDown() instead of the constructor and the</span></div>
<div class="line"><a id="l00879" name="l00879"></a><span class="lineno">  879</span><span class="comment">// destructor, as:</span></div>
<div class="line"><a id="l00880" name="l00880"></a><span class="lineno">  880</span><span class="comment">//</span></div>
<div class="line"><a id="l00881" name="l00881"></a><span class="lineno">  881</span><span class="comment">//   1. You cannot safely throw from a destructor.  This is a problem</span></div>
<div class="line"><a id="l00882" name="l00882"></a><span class="lineno">  882</span><span class="comment">//      as in some cases Google Test is used where exceptions are enabled, and</span></div>
<div class="line"><a id="l00883" name="l00883"></a><span class="lineno">  883</span><span class="comment">//      we may want to implement ASSERT_* using exceptions where they are</span></div>
<div class="line"><a id="l00884" name="l00884"></a><span class="lineno">  884</span><span class="comment">//      available.</span></div>
<div class="line"><a id="l00885" name="l00885"></a><span class="lineno">  885</span><span class="comment">//   2. You cannot use ASSERT_* directly in a constructor or</span></div>
<div class="line"><a id="l00886" name="l00886"></a><span class="lineno">  886</span><span class="comment">//      destructor.</span></div>
<div class="foldopen" id="foldopen00887" data-start="{" data-end="};">
<div class="line"><a id="l00887" name="l00887"></a><span class="lineno"><a class="line" href="class_environment.html">  887</a></span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1_environment.html">Environment</a> {</div>
<div class="line"><a id="l00888" name="l00888"></a><span class="lineno">  888</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00889" name="l00889"></a><span class="lineno">  889</span>  <span class="comment">// The d&#39;tor is virtual as we need to subclass Environment.</span></div>
<div class="line"><a id="l00890" name="l00890"></a><span class="lineno">  890</span>  <span class="keyword">virtual</span> <a class="code hl_class" href="classtesting_1_1_environment.html">~Environment</a>() {}</div>
<div class="line"><a id="l00891" name="l00891"></a><span class="lineno">  891</span> </div>
<div class="line"><a id="l00892" name="l00892"></a><span class="lineno">  892</span>  <span class="comment">// Override this to define how to set up the environment.</span></div>
<div class="line"><a id="l00893" name="l00893"></a><span class="lineno">  893</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> SetUp() {}</div>
<div class="line"><a id="l00894" name="l00894"></a><span class="lineno">  894</span> </div>
<div class="line"><a id="l00895" name="l00895"></a><span class="lineno">  895</span>  <span class="comment">// Override this to define how to tear down the environment.</span></div>
<div class="line"><a id="l00896" name="l00896"></a><span class="lineno">  896</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> TearDown() {}</div>
<div class="line"><a id="l00897" name="l00897"></a><span class="lineno">  897</span> </div>
<div class="line"><a id="l00898" name="l00898"></a><span class="lineno">  898</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00899" name="l00899"></a><span class="lineno">  899</span>  <span class="comment">// If you see an error about overriding the following function or</span></div>
<div class="line"><a id="l00900" name="l00900"></a><span class="lineno">  900</span>  <span class="comment">// about it being private, you have mis-spelled SetUp() as Setup().</span></div>
<div class="line"><a id="l00901" name="l00901"></a><span class="lineno">  901</span>  <span class="keyword">struct </span>Setup_should_be_spelled_SetUp {};</div>
<div class="line"><a id="l00902" name="l00902"></a><span class="lineno">  902</span>  <span class="keyword">virtual</span> Setup_should_be_spelled_SetUp* Setup() { <span class="keywordflow">return</span> <span class="keyword">nullptr</span>; }</div>
<div class="line"><a id="l00903" name="l00903"></a><span class="lineno">  903</span>};</div>
</div>
<div class="line"><a id="l00904" name="l00904"></a><span class="lineno">  904</span> </div>
<div class="line"><a id="l00905" name="l00905"></a><span class="lineno">  905</span><span class="preprocessor">#if GTEST_HAS_EXCEPTIONS</span></div>
<div class="line"><a id="l00906" name="l00906"></a><span class="lineno">  906</span> </div>
<div class="line"><a id="l00907" name="l00907"></a><span class="lineno">  907</span><span class="comment">// Exception which can be thrown from TestEventListener::OnTestPartResult.</span></div>
<div class="line"><a id="l00908" name="l00908"></a><span class="lineno">  908</span><span class="keyword">class </span>GTEST_API_ AssertionException</div>
<div class="line"><a id="l00909" name="l00909"></a><span class="lineno">  909</span>    : <span class="keyword">public</span> internal::GoogleTestFailureException {</div>
<div class="line"><a id="l00910" name="l00910"></a><span class="lineno">  910</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00911" name="l00911"></a><span class="lineno">  911</span>  <span class="keyword">explicit</span> AssertionException(<span class="keyword">const</span> TestPartResult&amp; result)</div>
<div class="line"><a id="l00912" name="l00912"></a><span class="lineno">  912</span>      : GoogleTestFailureException(result) {}</div>
<div class="line"><a id="l00913" name="l00913"></a><span class="lineno">  913</span>};</div>
<div class="line"><a id="l00914" name="l00914"></a><span class="lineno">  914</span> </div>
<div class="line"><a id="l00915" name="l00915"></a><span class="lineno">  915</span><span class="preprocessor">#endif  </span><span class="comment">// GTEST_HAS_EXCEPTIONS</span></div>
<div class="line"><a id="l00916" name="l00916"></a><span class="lineno">  916</span> </div>
<div class="line"><a id="l00917" name="l00917"></a><span class="lineno">  917</span><span class="comment">// The interface for tracing execution of tests. The methods are organized in</span></div>
<div class="line"><a id="l00918" name="l00918"></a><span class="lineno">  918</span><span class="comment">// the order the corresponding events are fired.</span></div>
<div class="foldopen" id="foldopen00919" data-start="{" data-end="};">
<div class="line"><a id="l00919" name="l00919"></a><span class="lineno"><a class="line" href="class_test_event_listener.html">  919</a></span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1_test_event_listener.html">TestEventListener</a> {</div>
<div class="line"><a id="l00920" name="l00920"></a><span class="lineno">  920</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00921" name="l00921"></a><span class="lineno">  921</span>  <span class="keyword">virtual</span> <a class="code hl_class" href="classtesting_1_1_test_event_listener.html">~TestEventListener</a>() {}</div>
<div class="line"><a id="l00922" name="l00922"></a><span class="lineno">  922</span> </div>
<div class="line"><a id="l00923" name="l00923"></a><span class="lineno">  923</span>  <span class="comment">// Fired before any test activity starts.</span></div>
<div class="line"><a id="l00924" name="l00924"></a><span class="lineno">  924</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestProgramStart(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; unit_test) = 0;</div>
<div class="line"><a id="l00925" name="l00925"></a><span class="lineno">  925</span> </div>
<div class="line"><a id="l00926" name="l00926"></a><span class="lineno">  926</span>  <span class="comment">// Fired before each iteration of tests starts.  There may be more than</span></div>
<div class="line"><a id="l00927" name="l00927"></a><span class="lineno">  927</span>  <span class="comment">// one iteration if GTEST_FLAG(repeat) is set. iteration is the iteration</span></div>
<div class="line"><a id="l00928" name="l00928"></a><span class="lineno">  928</span>  <span class="comment">// index, starting from 0.</span></div>
<div class="line"><a id="l00929" name="l00929"></a><span class="lineno">  929</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestIterationStart(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; unit_test,</div>
<div class="line"><a id="l00930" name="l00930"></a><span class="lineno">  930</span>                                    <span class="keywordtype">int</span> iteration) = 0;</div>
<div class="line"><a id="l00931" name="l00931"></a><span class="lineno">  931</span> </div>
<div class="line"><a id="l00932" name="l00932"></a><span class="lineno">  932</span>  <span class="comment">// Fired before environment set-up for each iteration of tests starts.</span></div>
<div class="line"><a id="l00933" name="l00933"></a><span class="lineno">  933</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsSetUpStart(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; unit_test) = 0;</div>
<div class="line"><a id="l00934" name="l00934"></a><span class="lineno">  934</span> </div>
<div class="line"><a id="l00935" name="l00935"></a><span class="lineno">  935</span>  <span class="comment">// Fired after environment set-up for each iteration of tests ends.</span></div>
<div class="line"><a id="l00936" name="l00936"></a><span class="lineno">  936</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsSetUpEnd(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; unit_test) = 0;</div>
<div class="line"><a id="l00937" name="l00937"></a><span class="lineno">  937</span> </div>
<div class="line"><a id="l00938" name="l00938"></a><span class="lineno">  938</span>  <span class="comment">// Fired before the test suite starts.</span></div>
<div class="line"><a id="l00939" name="l00939"></a><span class="lineno">  939</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestSuiteStart(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_suite.html">TestSuite</a>&amp; <span class="comment">/*test_suite*/</span>) {}</div>
<div class="line"><a id="l00940" name="l00940"></a><span class="lineno">  940</span> </div>
<div class="line"><a id="l00941" name="l00941"></a><span class="lineno">  941</span>  <span class="comment">//  Legacy API is deprecated but still available</span></div>
<div class="line"><a id="l00942" name="l00942"></a><span class="lineno">  942</span><span class="preprocessor">#ifndef GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l00943" name="l00943"></a><span class="lineno">  943</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestCaseStart(<span class="keyword">const</span> TestCase&amp; <span class="comment">/*test_case*/</span>) {}</div>
<div class="line"><a id="l00944" name="l00944"></a><span class="lineno">  944</span><span class="preprocessor">#endif  </span><span class="comment">//  GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l00945" name="l00945"></a><span class="lineno">  945</span> </div>
<div class="line"><a id="l00946" name="l00946"></a><span class="lineno">  946</span>  <span class="comment">// Fired before the test starts.</span></div>
<div class="line"><a id="l00947" name="l00947"></a><span class="lineno">  947</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestStart(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>&amp; test_info) = 0;</div>
<div class="line"><a id="l00948" name="l00948"></a><span class="lineno">  948</span> </div>
<div class="line"><a id="l00949" name="l00949"></a><span class="lineno">  949</span>  <span class="comment">// Fired when a test is disabled</span></div>
<div class="line"><a id="l00950" name="l00950"></a><span class="lineno">  950</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestDisabled(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>&amp; <span class="comment">/*test_info*/</span>) {}</div>
<div class="line"><a id="l00951" name="l00951"></a><span class="lineno">  951</span> </div>
<div class="line"><a id="l00952" name="l00952"></a><span class="lineno">  952</span>  <span class="comment">// Fired after a failed assertion or a SUCCEED() invocation.</span></div>
<div class="line"><a id="l00953" name="l00953"></a><span class="lineno">  953</span>  <span class="comment">// If you want to throw an exception from this function to skip to the next</span></div>
<div class="line"><a id="l00954" name="l00954"></a><span class="lineno">  954</span>  <span class="comment">// TEST, it must be AssertionException defined above, or inherited from it.</span></div>
<div class="line"><a id="l00955" name="l00955"></a><span class="lineno">  955</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestPartResult(<span class="keyword">const</span> TestPartResult&amp; test_part_result) = 0;</div>
<div class="line"><a id="l00956" name="l00956"></a><span class="lineno">  956</span> </div>
<div class="line"><a id="l00957" name="l00957"></a><span class="lineno">  957</span>  <span class="comment">// Fired after the test ends.</span></div>
<div class="line"><a id="l00958" name="l00958"></a><span class="lineno">  958</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestEnd(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>&amp; test_info) = 0;</div>
<div class="line"><a id="l00959" name="l00959"></a><span class="lineno">  959</span> </div>
<div class="line"><a id="l00960" name="l00960"></a><span class="lineno">  960</span>  <span class="comment">// Fired after the test suite ends.</span></div>
<div class="line"><a id="l00961" name="l00961"></a><span class="lineno">  961</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestSuiteEnd(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_suite.html">TestSuite</a>&amp; <span class="comment">/*test_suite*/</span>) {}</div>
<div class="line"><a id="l00962" name="l00962"></a><span class="lineno">  962</span> </div>
<div class="line"><a id="l00963" name="l00963"></a><span class="lineno">  963</span><span class="comment">//  Legacy API is deprecated but still available</span></div>
<div class="line"><a id="l00964" name="l00964"></a><span class="lineno">  964</span><span class="preprocessor">#ifndef GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l00965" name="l00965"></a><span class="lineno">  965</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestCaseEnd(<span class="keyword">const</span> TestCase&amp; <span class="comment">/*test_case*/</span>) {}</div>
<div class="line"><a id="l00966" name="l00966"></a><span class="lineno">  966</span><span class="preprocessor">#endif  </span><span class="comment">//  GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l00967" name="l00967"></a><span class="lineno">  967</span> </div>
<div class="line"><a id="l00968" name="l00968"></a><span class="lineno">  968</span>  <span class="comment">// Fired before environment tear-down for each iteration of tests starts.</span></div>
<div class="line"><a id="l00969" name="l00969"></a><span class="lineno">  969</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsTearDownStart(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; unit_test) = 0;</div>
<div class="line"><a id="l00970" name="l00970"></a><span class="lineno">  970</span> </div>
<div class="line"><a id="l00971" name="l00971"></a><span class="lineno">  971</span>  <span class="comment">// Fired after environment tear-down for each iteration of tests ends.</span></div>
<div class="line"><a id="l00972" name="l00972"></a><span class="lineno">  972</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnEnvironmentsTearDownEnd(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; unit_test) = 0;</div>
<div class="line"><a id="l00973" name="l00973"></a><span class="lineno">  973</span> </div>
<div class="line"><a id="l00974" name="l00974"></a><span class="lineno">  974</span>  <span class="comment">// Fired after each iteration of tests finishes.</span></div>
<div class="line"><a id="l00975" name="l00975"></a><span class="lineno">  975</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestIterationEnd(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; unit_test, <span class="keywordtype">int</span> iteration) = 0;</div>
<div class="line"><a id="l00976" name="l00976"></a><span class="lineno">  976</span> </div>
<div class="line"><a id="l00977" name="l00977"></a><span class="lineno">  977</span>  <span class="comment">// Fired after all test activities have ended.</span></div>
<div class="line"><a id="l00978" name="l00978"></a><span class="lineno">  978</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> OnTestProgramEnd(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; unit_test) = 0;</div>
<div class="line"><a id="l00979" name="l00979"></a><span class="lineno">  979</span>};</div>
</div>
<div class="line"><a id="l00980" name="l00980"></a><span class="lineno">  980</span> </div>
<div class="line"><a id="l00981" name="l00981"></a><span class="lineno">  981</span><span class="comment">// The convenience class for users who need to override just one or two</span></div>
<div class="line"><a id="l00982" name="l00982"></a><span class="lineno">  982</span><span class="comment">// methods and are not concerned that a possible change to a signature of</span></div>
<div class="line"><a id="l00983" name="l00983"></a><span class="lineno">  983</span><span class="comment">// the methods they override will not be caught during the build.  For</span></div>
<div class="line"><a id="l00984" name="l00984"></a><span class="lineno">  984</span><span class="comment">// comments about each method please see the definition of TestEventListener</span></div>
<div class="line"><a id="l00985" name="l00985"></a><span class="lineno">  985</span><span class="comment">// above.</span></div>
<div class="foldopen" id="foldopen00986" data-start="{" data-end="};">
<div class="line"><a id="l00986" name="l00986"></a><span class="lineno"><a class="line" href="class_empty_test_event_listener.html">  986</a></span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1_empty_test_event_listener.html">EmptyTestEventListener</a> : <span class="keyword">public</span> <a class="code hl_class" href="class_test_event_listener.html">TestEventListener</a> {</div>
<div class="line"><a id="l00987" name="l00987"></a><span class="lineno">  987</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00988" name="l00988"></a><span class="lineno">  988</span>  <span class="keywordtype">void</span> OnTestProgramStart(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; <span class="comment">/*unit_test*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l00989" name="l00989"></a><span class="lineno">  989</span>  <span class="keywordtype">void</span> OnTestIterationStart(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; <span class="comment">/*unit_test*/</span>,</div>
<div class="line"><a id="l00990" name="l00990"></a><span class="lineno">  990</span>                            <span class="keywordtype">int</span> <span class="comment">/*iteration*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l00991" name="l00991"></a><span class="lineno">  991</span>  <span class="keywordtype">void</span> OnEnvironmentsSetUpStart(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; <span class="comment">/*unit_test*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l00992" name="l00992"></a><span class="lineno">  992</span>  <span class="keywordtype">void</span> OnEnvironmentsSetUpEnd(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; <span class="comment">/*unit_test*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l00993" name="l00993"></a><span class="lineno">  993</span>  <span class="keywordtype">void</span> OnTestSuiteStart(<span class="keyword">const</span> <a class="code hl_class" href="class_test_suite.html">TestSuite</a>&amp; <span class="comment">/*test_suite*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l00994" name="l00994"></a><span class="lineno">  994</span><span class="comment">//  Legacy API is deprecated but still available</span></div>
<div class="line"><a id="l00995" name="l00995"></a><span class="lineno">  995</span><span class="preprocessor">#ifndef GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l00996" name="l00996"></a><span class="lineno">  996</span>  <span class="keywordtype">void</span> OnTestCaseStart(<span class="keyword">const</span> TestCase&amp; <span class="comment">/*test_case*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l00997" name="l00997"></a><span class="lineno">  997</span><span class="preprocessor">#endif  </span><span class="comment">//  GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l00998" name="l00998"></a><span class="lineno">  998</span> </div>
<div class="line"><a id="l00999" name="l00999"></a><span class="lineno">  999</span>  <span class="keywordtype">void</span> OnTestStart(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>&amp; <span class="comment">/*test_info*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l01000" name="l01000"></a><span class="lineno"> 1000</span>  <span class="keywordtype">void</span> OnTestDisabled(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>&amp; <span class="comment">/*test_info*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l01001" name="l01001"></a><span class="lineno"> 1001</span>  <span class="keywordtype">void</span> OnTestPartResult(<span class="keyword">const</span> TestPartResult&amp; <span class="comment">/*test_part_result*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l01002" name="l01002"></a><span class="lineno"> 1002</span>  <span class="keywordtype">void</span> OnTestEnd(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>&amp; <span class="comment">/*test_info*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l01003" name="l01003"></a><span class="lineno"> 1003</span>  <span class="keywordtype">void</span> OnTestSuiteEnd(<span class="keyword">const</span> <a class="code hl_class" href="class_test_suite.html">TestSuite</a>&amp; <span class="comment">/*test_suite*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l01004" name="l01004"></a><span class="lineno"> 1004</span><span class="preprocessor">#ifndef GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l01005" name="l01005"></a><span class="lineno"> 1005</span>  <span class="keywordtype">void</span> OnTestCaseEnd(<span class="keyword">const</span> TestCase&amp; <span class="comment">/*test_case*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l01006" name="l01006"></a><span class="lineno"> 1006</span><span class="preprocessor">#endif  </span><span class="comment">//  GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l01007" name="l01007"></a><span class="lineno"> 1007</span> </div>
<div class="line"><a id="l01008" name="l01008"></a><span class="lineno"> 1008</span>  <span class="keywordtype">void</span> OnEnvironmentsTearDownStart(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; <span class="comment">/*unit_test*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l01009" name="l01009"></a><span class="lineno"> 1009</span>  <span class="keywordtype">void</span> OnEnvironmentsTearDownEnd(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; <span class="comment">/*unit_test*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l01010" name="l01010"></a><span class="lineno"> 1010</span>  <span class="keywordtype">void</span> OnTestIterationEnd(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; <span class="comment">/*unit_test*/</span>,</div>
<div class="line"><a id="l01011" name="l01011"></a><span class="lineno"> 1011</span>                          <span class="keywordtype">int</span> <span class="comment">/*iteration*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l01012" name="l01012"></a><span class="lineno"> 1012</span>  <span class="keywordtype">void</span> OnTestProgramEnd(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_unit_test.html">UnitTest</a>&amp; <span class="comment">/*unit_test*/</span>)<span class="keyword"> override </span>{}</div>
<div class="line"><a id="l01013" name="l01013"></a><span class="lineno"> 1013</span>};</div>
</div>
<div class="line"><a id="l01014" name="l01014"></a><span class="lineno"> 1014</span> </div>
<div class="line"><a id="l01015" name="l01015"></a><span class="lineno"> 1015</span><span class="comment">// TestEventListeners lets users add listeners to track events in Google Test.</span></div>
<div class="foldopen" id="foldopen01016" data-start="{" data-end="};">
<div class="line"><a id="l01016" name="l01016"></a><span class="lineno"><a class="line" href="class_test_event_listeners.html"> 1016</a></span><span class="keyword">class </span>GTEST_API_ TestEventListeners {</div>
<div class="line"><a id="l01017" name="l01017"></a><span class="lineno"> 1017</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01018" name="l01018"></a><span class="lineno"> 1018</span>  TestEventListeners();</div>
<div class="line"><a id="l01019" name="l01019"></a><span class="lineno"> 1019</span>  ~TestEventListeners();</div>
<div class="line"><a id="l01020" name="l01020"></a><span class="lineno"> 1020</span> </div>
<div class="line"><a id="l01021" name="l01021"></a><span class="lineno"> 1021</span>  <span class="comment">// Appends an event listener to the end of the list. Google Test assumes</span></div>
<div class="line"><a id="l01022" name="l01022"></a><span class="lineno"> 1022</span>  <span class="comment">// the ownership of the listener (i.e. it will delete the listener when</span></div>
<div class="line"><a id="l01023" name="l01023"></a><span class="lineno"> 1023</span>  <span class="comment">// the test program finishes).</span></div>
<div class="line"><a id="l01024" name="l01024"></a><span class="lineno"> 1024</span>  <span class="keywordtype">void</span> Append(<a class="code hl_class" href="class_test_event_listener.html">TestEventListener</a>* listener);</div>
<div class="line"><a id="l01025" name="l01025"></a><span class="lineno"> 1025</span> </div>
<div class="line"><a id="l01026" name="l01026"></a><span class="lineno"> 1026</span>  <span class="comment">// Removes the given event listener from the list and returns it.  It then</span></div>
<div class="line"><a id="l01027" name="l01027"></a><span class="lineno"> 1027</span>  <span class="comment">// becomes the caller&#39;s responsibility to delete the listener. Returns</span></div>
<div class="line"><a id="l01028" name="l01028"></a><span class="lineno"> 1028</span>  <span class="comment">// NULL if the listener is not found in the list.</span></div>
<div class="line"><a id="l01029" name="l01029"></a><span class="lineno"> 1029</span>  <a class="code hl_class" href="class_test_event_listener.html">TestEventListener</a>* Release(<a class="code hl_class" href="class_test_event_listener.html">TestEventListener</a>* listener);</div>
<div class="line"><a id="l01030" name="l01030"></a><span class="lineno"> 1030</span> </div>
<div class="line"><a id="l01031" name="l01031"></a><span class="lineno"> 1031</span>  <span class="comment">// Returns the standard listener responsible for the default console</span></div>
<div class="line"><a id="l01032" name="l01032"></a><span class="lineno"> 1032</span>  <span class="comment">// output.  Can be removed from the listeners list to shut down default</span></div>
<div class="line"><a id="l01033" name="l01033"></a><span class="lineno"> 1033</span>  <span class="comment">// console output.  Note that removing this object from the listener list</span></div>
<div class="line"><a id="l01034" name="l01034"></a><span class="lineno"> 1034</span>  <span class="comment">// with Release transfers its ownership to the caller and makes this</span></div>
<div class="line"><a id="l01035" name="l01035"></a><span class="lineno"> 1035</span>  <span class="comment">// function return NULL the next time.</span></div>
<div class="line"><a id="l01036" name="l01036"></a><span class="lineno"> 1036</span>  <a class="code hl_class" href="class_test_event_listener.html">TestEventListener</a>* default_result_printer()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l01037" name="l01037"></a><span class="lineno"> 1037</span>    <span class="keywordflow">return</span> default_result_printer_;</div>
<div class="line"><a id="l01038" name="l01038"></a><span class="lineno"> 1038</span>  }</div>
<div class="line"><a id="l01039" name="l01039"></a><span class="lineno"> 1039</span> </div>
<div class="line"><a id="l01040" name="l01040"></a><span class="lineno"> 1040</span>  <span class="comment">// Returns the standard listener responsible for the default XML output</span></div>
<div class="line"><a id="l01041" name="l01041"></a><span class="lineno"> 1041</span>  <span class="comment">// controlled by the --gtest_output=xml flag.  Can be removed from the</span></div>
<div class="line"><a id="l01042" name="l01042"></a><span class="lineno"> 1042</span>  <span class="comment">// listeners list by users who want to shut down the default XML output</span></div>
<div class="line"><a id="l01043" name="l01043"></a><span class="lineno"> 1043</span>  <span class="comment">// controlled by this flag and substitute it with custom one.  Note that</span></div>
<div class="line"><a id="l01044" name="l01044"></a><span class="lineno"> 1044</span>  <span class="comment">// removing this object from the listener list with Release transfers its</span></div>
<div class="line"><a id="l01045" name="l01045"></a><span class="lineno"> 1045</span>  <span class="comment">// ownership to the caller and makes this function return NULL the next</span></div>
<div class="line"><a id="l01046" name="l01046"></a><span class="lineno"> 1046</span>  <span class="comment">// time.</span></div>
<div class="line"><a id="l01047" name="l01047"></a><span class="lineno"> 1047</span>  <a class="code hl_class" href="class_test_event_listener.html">TestEventListener</a>* default_xml_generator()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l01048" name="l01048"></a><span class="lineno"> 1048</span>    <span class="keywordflow">return</span> default_xml_generator_;</div>
<div class="line"><a id="l01049" name="l01049"></a><span class="lineno"> 1049</span>  }</div>
<div class="line"><a id="l01050" name="l01050"></a><span class="lineno"> 1050</span> </div>
<div class="line"><a id="l01051" name="l01051"></a><span class="lineno"> 1051</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l01052" name="l01052"></a><span class="lineno"> 1052</span>  <span class="keyword">friend</span> <span class="keyword">class </span>TestSuite;</div>
<div class="line"><a id="l01053" name="l01053"></a><span class="lineno"> 1053</span>  <span class="keyword">friend</span> <span class="keyword">class </span>TestInfo;</div>
<div class="line"><a id="l01054" name="l01054"></a><span class="lineno"> 1054</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::DefaultGlobalTestPartResultReporter;</div>
<div class="line"><a id="l01055" name="l01055"></a><span class="lineno"> 1055</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::NoExecDeathTest;</div>
<div class="line"><a id="l01056" name="l01056"></a><span class="lineno"> 1056</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::TestEventListenersAccessor;</div>
<div class="line"><a id="l01057" name="l01057"></a><span class="lineno"> 1057</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::UnitTestImpl;</div>
<div class="line"><a id="l01058" name="l01058"></a><span class="lineno"> 1058</span> </div>
<div class="line"><a id="l01059" name="l01059"></a><span class="lineno"> 1059</span>  <span class="comment">// Returns repeater that broadcasts the TestEventListener events to all</span></div>
<div class="line"><a id="l01060" name="l01060"></a><span class="lineno"> 1060</span>  <span class="comment">// subscribers.</span></div>
<div class="line"><a id="l01061" name="l01061"></a><span class="lineno"> 1061</span>  <a class="code hl_class" href="class_test_event_listener.html">TestEventListener</a>* repeater();</div>
<div class="line"><a id="l01062" name="l01062"></a><span class="lineno"> 1062</span> </div>
<div class="line"><a id="l01063" name="l01063"></a><span class="lineno"> 1063</span>  <span class="comment">// Sets the default_result_printer attribute to the provided listener.</span></div>
<div class="line"><a id="l01064" name="l01064"></a><span class="lineno"> 1064</span>  <span class="comment">// The listener is also added to the listener list and previous</span></div>
<div class="line"><a id="l01065" name="l01065"></a><span class="lineno"> 1065</span>  <span class="comment">// default_result_printer is removed from it and deleted. The listener can</span></div>
<div class="line"><a id="l01066" name="l01066"></a><span class="lineno"> 1066</span>  <span class="comment">// also be NULL in which case it will not be added to the list. Does</span></div>
<div class="line"><a id="l01067" name="l01067"></a><span class="lineno"> 1067</span>  <span class="comment">// nothing if the previous and the current listener objects are the same.</span></div>
<div class="line"><a id="l01068" name="l01068"></a><span class="lineno"> 1068</span>  <span class="keywordtype">void</span> SetDefaultResultPrinter(<a class="code hl_class" href="class_test_event_listener.html">TestEventListener</a>* listener);</div>
<div class="line"><a id="l01069" name="l01069"></a><span class="lineno"> 1069</span> </div>
<div class="line"><a id="l01070" name="l01070"></a><span class="lineno"> 1070</span>  <span class="comment">// Sets the default_xml_generator attribute to the provided listener.  The</span></div>
<div class="line"><a id="l01071" name="l01071"></a><span class="lineno"> 1071</span>  <span class="comment">// listener is also added to the listener list and previous</span></div>
<div class="line"><a id="l01072" name="l01072"></a><span class="lineno"> 1072</span>  <span class="comment">// default_xml_generator is removed from it and deleted. The listener can</span></div>
<div class="line"><a id="l01073" name="l01073"></a><span class="lineno"> 1073</span>  <span class="comment">// also be NULL in which case it will not be added to the list. Does</span></div>
<div class="line"><a id="l01074" name="l01074"></a><span class="lineno"> 1074</span>  <span class="comment">// nothing if the previous and the current listener objects are the same.</span></div>
<div class="line"><a id="l01075" name="l01075"></a><span class="lineno"> 1075</span>  <span class="keywordtype">void</span> SetDefaultXmlGenerator(<a class="code hl_class" href="class_test_event_listener.html">TestEventListener</a>* listener);</div>
<div class="line"><a id="l01076" name="l01076"></a><span class="lineno"> 1076</span> </div>
<div class="line"><a id="l01077" name="l01077"></a><span class="lineno"> 1077</span>  <span class="comment">// Controls whether events will be forwarded by the repeater to the</span></div>
<div class="line"><a id="l01078" name="l01078"></a><span class="lineno"> 1078</span>  <span class="comment">// listeners in the list.</span></div>
<div class="line"><a id="l01079" name="l01079"></a><span class="lineno"> 1079</span>  <span class="keywordtype">bool</span> EventForwardingEnabled() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01080" name="l01080"></a><span class="lineno"> 1080</span>  <span class="keywordtype">void</span> SuppressEventForwarding();</div>
<div class="line"><a id="l01081" name="l01081"></a><span class="lineno"> 1081</span> </div>
<div class="line"><a id="l01082" name="l01082"></a><span class="lineno"> 1082</span>  <span class="comment">// The actual list of listeners.</span></div>
<div class="line"><a id="l01083" name="l01083"></a><span class="lineno"> 1083</span>  internal::TestEventRepeater* repeater_;</div>
<div class="line"><a id="l01084" name="l01084"></a><span class="lineno"> 1084</span>  <span class="comment">// Listener responsible for the standard result output.</span></div>
<div class="line"><a id="l01085" name="l01085"></a><span class="lineno"> 1085</span>  <a class="code hl_class" href="class_test_event_listener.html">TestEventListener</a>* default_result_printer_;</div>
<div class="line"><a id="l01086" name="l01086"></a><span class="lineno"> 1086</span>  <span class="comment">// Listener responsible for the creation of the XML output file.</span></div>
<div class="line"><a id="l01087" name="l01087"></a><span class="lineno"> 1087</span>  <a class="code hl_class" href="class_test_event_listener.html">TestEventListener</a>* default_xml_generator_;</div>
<div class="line"><a id="l01088" name="l01088"></a><span class="lineno"> 1088</span> </div>
<div class="line"><a id="l01089" name="l01089"></a><span class="lineno"> 1089</span>  <span class="comment">// We disallow copying TestEventListeners.</span></div>
<div class="line"><a id="l01090" name="l01090"></a><span class="lineno"> 1090</span>  TestEventListeners(<span class="keyword">const</span> TestEventListeners&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01091" name="l01091"></a><span class="lineno"> 1091</span>  TestEventListeners&amp; operator=(<span class="keyword">const</span> TestEventListeners&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01092" name="l01092"></a><span class="lineno"> 1092</span>};</div>
</div>
<div class="line"><a id="l01093" name="l01093"></a><span class="lineno"> 1093</span> </div>
<div class="line"><a id="l01094" name="l01094"></a><span class="lineno"> 1094</span><span class="comment">// A UnitTest consists of a vector of TestSuites.</span></div>
<div class="line"><a id="l01095" name="l01095"></a><span class="lineno"> 1095</span><span class="comment">//</span></div>
<div class="line"><a id="l01096" name="l01096"></a><span class="lineno"> 1096</span><span class="comment">// This is a singleton class.  The only instance of UnitTest is</span></div>
<div class="line"><a id="l01097" name="l01097"></a><span class="lineno"> 1097</span><span class="comment">// created when UnitTest::GetInstance() is first called.  This</span></div>
<div class="line"><a id="l01098" name="l01098"></a><span class="lineno"> 1098</span><span class="comment">// instance is never deleted.</span></div>
<div class="line"><a id="l01099" name="l01099"></a><span class="lineno"> 1099</span><span class="comment">//</span></div>
<div class="line"><a id="l01100" name="l01100"></a><span class="lineno"> 1100</span><span class="comment">// UnitTest is not copyable.</span></div>
<div class="line"><a id="l01101" name="l01101"></a><span class="lineno"> 1101</span><span class="comment">//</span></div>
<div class="line"><a id="l01102" name="l01102"></a><span class="lineno"> 1102</span><span class="comment">// This class is thread-safe as long as the methods are called</span></div>
<div class="line"><a id="l01103" name="l01103"></a><span class="lineno"> 1103</span><span class="comment">// according to their specification.</span></div>
<div class="foldopen" id="foldopen01104" data-start="{" data-end="};">
<div class="line"><a id="l01104" name="l01104"></a><span class="lineno"><a class="line" href="classtesting_1_1_unit_test.html"> 1104</a></span><span class="keyword">class </span>GTEST_API_ UnitTest {</div>
<div class="line"><a id="l01105" name="l01105"></a><span class="lineno"> 1105</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01106" name="l01106"></a><span class="lineno"> 1106</span>  <span class="comment">// Gets the singleton UnitTest object.  The first time this method</span></div>
<div class="line"><a id="l01107" name="l01107"></a><span class="lineno"> 1107</span>  <span class="comment">// is called, a UnitTest object is constructed and returned.</span></div>
<div class="line"><a id="l01108" name="l01108"></a><span class="lineno"> 1108</span>  <span class="comment">// Consecutive calls will return the same object.</span></div>
<div class="line"><a id="l01109" name="l01109"></a><span class="lineno"> 1109</span>  <span class="keyword">static</span> UnitTest* GetInstance();</div>
<div class="line"><a id="l01110" name="l01110"></a><span class="lineno"> 1110</span> </div>
<div class="line"><a id="l01111" name="l01111"></a><span class="lineno"> 1111</span>  <span class="comment">// Runs all tests in this UnitTest object and prints the result.</span></div>
<div class="line"><a id="l01112" name="l01112"></a><span class="lineno"> 1112</span>  <span class="comment">// Returns 0 if successful, or 1 otherwise.</span></div>
<div class="line"><a id="l01113" name="l01113"></a><span class="lineno"> 1113</span>  <span class="comment">//</span></div>
<div class="line"><a id="l01114" name="l01114"></a><span class="lineno"> 1114</span>  <span class="comment">// This method can only be called from the main thread.</span></div>
<div class="line"><a id="l01115" name="l01115"></a><span class="lineno"> 1115</span>  <span class="comment">//</span></div>
<div class="line"><a id="l01116" name="l01116"></a><span class="lineno"> 1116</span>  <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01117" name="l01117"></a><span class="lineno"> 1117</span>  <span class="keywordtype">int</span> Run() GTEST_MUST_USE_RESULT_;</div>
<div class="line"><a id="l01118" name="l01118"></a><span class="lineno"> 1118</span> </div>
<div class="line"><a id="l01119" name="l01119"></a><span class="lineno"> 1119</span>  <span class="comment">// Returns the working directory when the first TEST() or TEST_F()</span></div>
<div class="line"><a id="l01120" name="l01120"></a><span class="lineno"> 1120</span>  <span class="comment">// was executed.  The UnitTest object owns the string.</span></div>
<div class="line"><a id="l01121" name="l01121"></a><span class="lineno"> 1121</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* original_working_dir() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01122" name="l01122"></a><span class="lineno"> 1122</span> </div>
<div class="line"><a id="l01123" name="l01123"></a><span class="lineno"> 1123</span>  <span class="comment">// Returns the TestSuite object for the test that&#39;s currently running,</span></div>
<div class="line"><a id="l01124" name="l01124"></a><span class="lineno"> 1124</span>  <span class="comment">// or NULL if no test is running.</span></div>
<div class="line"><a id="l01125" name="l01125"></a><span class="lineno"> 1125</span>  <span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_suite.html">TestSuite</a>* current_test_suite() <span class="keyword">const</span> GTEST_LOCK_EXCLUDED_(mutex_);</div>
<div class="line"><a id="l01126" name="l01126"></a><span class="lineno"> 1126</span> </div>
<div class="line"><a id="l01127" name="l01127"></a><span class="lineno"> 1127</span><span class="comment">// Legacy API is still available but deprecated</span></div>
<div class="line"><a id="l01128" name="l01128"></a><span class="lineno"> 1128</span><span class="preprocessor">#ifndef GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l01129" name="l01129"></a><span class="lineno"> 1129</span>  <span class="keyword">const</span> TestCase* current_test_case() <span class="keyword">const</span> GTEST_LOCK_EXCLUDED_(mutex_);</div>
<div class="line"><a id="l01130" name="l01130"></a><span class="lineno"> 1130</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01131" name="l01131"></a><span class="lineno"> 1131</span> </div>
<div class="line"><a id="l01132" name="l01132"></a><span class="lineno"> 1132</span>  <span class="comment">// Returns the TestInfo object for the test that&#39;s currently running,</span></div>
<div class="line"><a id="l01133" name="l01133"></a><span class="lineno"> 1133</span>  <span class="comment">// or NULL if no test is running.</span></div>
<div class="line"><a id="l01134" name="l01134"></a><span class="lineno"> 1134</span>  <span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_info.html">TestInfo</a>* current_test_info() <span class="keyword">const</span> GTEST_LOCK_EXCLUDED_(mutex_);</div>
<div class="line"><a id="l01135" name="l01135"></a><span class="lineno"> 1135</span> </div>
<div class="line"><a id="l01136" name="l01136"></a><span class="lineno"> 1136</span>  <span class="comment">// Returns the random seed used at the start of the current test run.</span></div>
<div class="line"><a id="l01137" name="l01137"></a><span class="lineno"> 1137</span>  <span class="keywordtype">int</span> random_seed() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01138" name="l01138"></a><span class="lineno"> 1138</span> </div>
<div class="line"><a id="l01139" name="l01139"></a><span class="lineno"> 1139</span>  <span class="comment">// Returns the ParameterizedTestSuiteRegistry object used to keep track of</span></div>
<div class="line"><a id="l01140" name="l01140"></a><span class="lineno"> 1140</span>  <span class="comment">// value-parameterized tests and instantiate and register them.</span></div>
<div class="line"><a id="l01141" name="l01141"></a><span class="lineno"> 1141</span>  <span class="comment">//</span></div>
<div class="line"><a id="l01142" name="l01142"></a><span class="lineno"> 1142</span>  <span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01143" name="l01143"></a><span class="lineno"> 1143</span>  <a class="code hl_class" href="classtesting_1_1internal_1_1_parameterized_test_suite_registry.html">internal::ParameterizedTestSuiteRegistry</a>&amp; parameterized_test_registry()</div>
<div class="line"><a id="l01144" name="l01144"></a><span class="lineno"> 1144</span>      GTEST_LOCK_EXCLUDED_(mutex_);</div>
<div class="line"><a id="l01145" name="l01145"></a><span class="lineno"> 1145</span> </div>
<div class="line"><a id="l01146" name="l01146"></a><span class="lineno"> 1146</span>  <span class="comment">// Gets the number of successful test suites.</span></div>
<div class="line"><a id="l01147" name="l01147"></a><span class="lineno"> 1147</span>  <span class="keywordtype">int</span> successful_test_suite_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01148" name="l01148"></a><span class="lineno"> 1148</span> </div>
<div class="line"><a id="l01149" name="l01149"></a><span class="lineno"> 1149</span>  <span class="comment">// Gets the number of failed test suites.</span></div>
<div class="line"><a id="l01150" name="l01150"></a><span class="lineno"> 1150</span>  <span class="keywordtype">int</span> failed_test_suite_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01151" name="l01151"></a><span class="lineno"> 1151</span> </div>
<div class="line"><a id="l01152" name="l01152"></a><span class="lineno"> 1152</span>  <span class="comment">// Gets the number of all test suites.</span></div>
<div class="line"><a id="l01153" name="l01153"></a><span class="lineno"> 1153</span>  <span class="keywordtype">int</span> total_test_suite_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01154" name="l01154"></a><span class="lineno"> 1154</span> </div>
<div class="line"><a id="l01155" name="l01155"></a><span class="lineno"> 1155</span>  <span class="comment">// Gets the number of all test suites that contain at least one test</span></div>
<div class="line"><a id="l01156" name="l01156"></a><span class="lineno"> 1156</span>  <span class="comment">// that should run.</span></div>
<div class="line"><a id="l01157" name="l01157"></a><span class="lineno"> 1157</span>  <span class="keywordtype">int</span> test_suite_to_run_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01158" name="l01158"></a><span class="lineno"> 1158</span> </div>
<div class="line"><a id="l01159" name="l01159"></a><span class="lineno"> 1159</span>  <span class="comment">//  Legacy API is deprecated but still available</span></div>
<div class="line"><a id="l01160" name="l01160"></a><span class="lineno"> 1160</span><span class="preprocessor">#ifndef GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l01161" name="l01161"></a><span class="lineno"> 1161</span>  <span class="keywordtype">int</span> successful_test_case_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01162" name="l01162"></a><span class="lineno"> 1162</span>  <span class="keywordtype">int</span> failed_test_case_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01163" name="l01163"></a><span class="lineno"> 1163</span>  <span class="keywordtype">int</span> total_test_case_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01164" name="l01164"></a><span class="lineno"> 1164</span>  <span class="keywordtype">int</span> test_case_to_run_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01165" name="l01165"></a><span class="lineno"> 1165</span><span class="preprocessor">#endif  </span><span class="comment">//  GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l01166" name="l01166"></a><span class="lineno"> 1166</span> </div>
<div class="line"><a id="l01167" name="l01167"></a><span class="lineno"> 1167</span>  <span class="comment">// Gets the number of successful tests.</span></div>
<div class="line"><a id="l01168" name="l01168"></a><span class="lineno"> 1168</span>  <span class="keywordtype">int</span> successful_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01169" name="l01169"></a><span class="lineno"> 1169</span> </div>
<div class="line"><a id="l01170" name="l01170"></a><span class="lineno"> 1170</span>  <span class="comment">// Gets the number of skipped tests.</span></div>
<div class="line"><a id="l01171" name="l01171"></a><span class="lineno"> 1171</span>  <span class="keywordtype">int</span> skipped_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01172" name="l01172"></a><span class="lineno"> 1172</span> </div>
<div class="line"><a id="l01173" name="l01173"></a><span class="lineno"> 1173</span>  <span class="comment">// Gets the number of failed tests.</span></div>
<div class="line"><a id="l01174" name="l01174"></a><span class="lineno"> 1174</span>  <span class="keywordtype">int</span> failed_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01175" name="l01175"></a><span class="lineno"> 1175</span> </div>
<div class="line"><a id="l01176" name="l01176"></a><span class="lineno"> 1176</span>  <span class="comment">// Gets the number of disabled tests that will be reported in the XML report.</span></div>
<div class="line"><a id="l01177" name="l01177"></a><span class="lineno"> 1177</span>  <span class="keywordtype">int</span> reportable_disabled_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01178" name="l01178"></a><span class="lineno"> 1178</span> </div>
<div class="line"><a id="l01179" name="l01179"></a><span class="lineno"> 1179</span>  <span class="comment">// Gets the number of disabled tests.</span></div>
<div class="line"><a id="l01180" name="l01180"></a><span class="lineno"> 1180</span>  <span class="keywordtype">int</span> disabled_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01181" name="l01181"></a><span class="lineno"> 1181</span> </div>
<div class="line"><a id="l01182" name="l01182"></a><span class="lineno"> 1182</span>  <span class="comment">// Gets the number of tests to be printed in the XML report.</span></div>
<div class="line"><a id="l01183" name="l01183"></a><span class="lineno"> 1183</span>  <span class="keywordtype">int</span> reportable_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01184" name="l01184"></a><span class="lineno"> 1184</span> </div>
<div class="line"><a id="l01185" name="l01185"></a><span class="lineno"> 1185</span>  <span class="comment">// Gets the number of all tests.</span></div>
<div class="line"><a id="l01186" name="l01186"></a><span class="lineno"> 1186</span>  <span class="keywordtype">int</span> total_test_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01187" name="l01187"></a><span class="lineno"> 1187</span> </div>
<div class="line"><a id="l01188" name="l01188"></a><span class="lineno"> 1188</span>  <span class="comment">// Gets the number of tests that should run.</span></div>
<div class="line"><a id="l01189" name="l01189"></a><span class="lineno"> 1189</span>  <span class="keywordtype">int</span> test_to_run_count() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01190" name="l01190"></a><span class="lineno"> 1190</span> </div>
<div class="line"><a id="l01191" name="l01191"></a><span class="lineno"> 1191</span>  <span class="comment">// Gets the time of the test program start, in ms from the start of the</span></div>
<div class="line"><a id="l01192" name="l01192"></a><span class="lineno"> 1192</span>  <span class="comment">// UNIX epoch.</span></div>
<div class="line"><a id="l01193" name="l01193"></a><span class="lineno"> 1193</span>  TimeInMillis start_timestamp() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01194" name="l01194"></a><span class="lineno"> 1194</span> </div>
<div class="line"><a id="l01195" name="l01195"></a><span class="lineno"> 1195</span>  <span class="comment">// Gets the elapsed time, in milliseconds.</span></div>
<div class="line"><a id="l01196" name="l01196"></a><span class="lineno"> 1196</span>  TimeInMillis elapsed_time() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01197" name="l01197"></a><span class="lineno"> 1197</span> </div>
<div class="line"><a id="l01198" name="l01198"></a><span class="lineno"> 1198</span>  <span class="comment">// Returns true if and only if the unit test passed (i.e. all test suites</span></div>
<div class="line"><a id="l01199" name="l01199"></a><span class="lineno"> 1199</span>  <span class="comment">// passed).</span></div>
<div class="line"><a id="l01200" name="l01200"></a><span class="lineno"> 1200</span>  <span class="keywordtype">bool</span> Passed() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01201" name="l01201"></a><span class="lineno"> 1201</span> </div>
<div class="line"><a id="l01202" name="l01202"></a><span class="lineno"> 1202</span>  <span class="comment">// Returns true if and only if the unit test failed (i.e. some test suite</span></div>
<div class="line"><a id="l01203" name="l01203"></a><span class="lineno"> 1203</span>  <span class="comment">// failed or something outside of all tests failed).</span></div>
<div class="line"><a id="l01204" name="l01204"></a><span class="lineno"> 1204</span>  <span class="keywordtype">bool</span> Failed() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01205" name="l01205"></a><span class="lineno"> 1205</span> </div>
<div class="line"><a id="l01206" name="l01206"></a><span class="lineno"> 1206</span>  <span class="comment">// Gets the i-th test suite among all the test suites. i can range from 0 to</span></div>
<div class="line"><a id="l01207" name="l01207"></a><span class="lineno"> 1207</span>  <span class="comment">// total_test_suite_count() - 1. If i is not in that range, returns NULL.</span></div>
<div class="line"><a id="l01208" name="l01208"></a><span class="lineno"> 1208</span>  <span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_suite.html">TestSuite</a>* GetTestSuite(<span class="keywordtype">int</span> i) <span class="keyword">const</span>;</div>
<div class="line"><a id="l01209" name="l01209"></a><span class="lineno"> 1209</span> </div>
<div class="line"><a id="l01210" name="l01210"></a><span class="lineno"> 1210</span><span class="comment">//  Legacy API is deprecated but still available</span></div>
<div class="line"><a id="l01211" name="l01211"></a><span class="lineno"> 1211</span><span class="preprocessor">#ifndef GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l01212" name="l01212"></a><span class="lineno"> 1212</span>  <span class="keyword">const</span> TestCase* GetTestCase(<span class="keywordtype">int</span> i) <span class="keyword">const</span>;</div>
<div class="line"><a id="l01213" name="l01213"></a><span class="lineno"> 1213</span><span class="preprocessor">#endif  </span><span class="comment">//  GTEST_REMOVE_LEGACY_TEST_CASEAPI_</span></div>
<div class="line"><a id="l01214" name="l01214"></a><span class="lineno"> 1214</span> </div>
<div class="line"><a id="l01215" name="l01215"></a><span class="lineno"> 1215</span>  <span class="comment">// Returns the TestResult containing information on test failures and</span></div>
<div class="line"><a id="l01216" name="l01216"></a><span class="lineno"> 1216</span>  <span class="comment">// properties logged outside of individual test suites.</span></div>
<div class="line"><a id="l01217" name="l01217"></a><span class="lineno"> 1217</span>  <span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_test_result.html">TestResult</a>&amp; ad_hoc_test_result() <span class="keyword">const</span>;</div>
<div class="line"><a id="l01218" name="l01218"></a><span class="lineno"> 1218</span> </div>
<div class="line"><a id="l01219" name="l01219"></a><span class="lineno"> 1219</span>  <span class="comment">// Returns the list of event listeners that can be used to track events</span></div>
<div class="line"><a id="l01220" name="l01220"></a><span class="lineno"> 1220</span>  <span class="comment">// inside Google Test.</span></div>
<div class="line"><a id="l01221" name="l01221"></a><span class="lineno"> 1221</span>  <a class="code hl_class" href="classtesting_1_1_test_event_listeners.html">TestEventListeners</a>&amp; listeners();</div>
<div class="line"><a id="l01222" name="l01222"></a><span class="lineno"> 1222</span> </div>
<div class="line"><a id="l01223" name="l01223"></a><span class="lineno"> 1223</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l01224" name="l01224"></a><span class="lineno"> 1224</span>  <span class="comment">// Registers and returns a global test environment.  When a test</span></div>
<div class="line"><a id="l01225" name="l01225"></a><span class="lineno"> 1225</span>  <span class="comment">// program is run, all global test environments will be set-up in</span></div>
<div class="line"><a id="l01226" name="l01226"></a><span class="lineno"> 1226</span>  <span class="comment">// the order they were registered.  After all tests in the program</span></div>
<div class="line"><a id="l01227" name="l01227"></a><span class="lineno"> 1227</span>  <span class="comment">// have finished, all global test environments will be torn-down in</span></div>
<div class="line"><a id="l01228" name="l01228"></a><span class="lineno"> 1228</span>  <span class="comment">// the *reverse* order they were registered.</span></div>
<div class="line"><a id="l01229" name="l01229"></a><span class="lineno"> 1229</span>  <span class="comment">//</span></div>
<div class="line"><a id="l01230" name="l01230"></a><span class="lineno"> 1230</span>  <span class="comment">// The UnitTest object takes ownership of the given environment.</span></div>
<div class="line"><a id="l01231" name="l01231"></a><span class="lineno"> 1231</span>  <span class="comment">//</span></div>
<div class="line"><a id="l01232" name="l01232"></a><span class="lineno"> 1232</span>  <span class="comment">// This method can only be called from the main thread.</span></div>
<div class="line"><a id="l01233" name="l01233"></a><span class="lineno"> 1233</span>  <a class="code hl_class" href="classtesting_1_1_environment.html">Environment</a>* AddEnvironment(<a class="code hl_class" href="classtesting_1_1_environment.html">Environment</a>* env);</div>
<div class="line"><a id="l01234" name="l01234"></a><span class="lineno"> 1234</span> </div>
<div class="line"><a id="l01235" name="l01235"></a><span class="lineno"> 1235</span>  <span class="comment">// Adds a TestPartResult to the current TestResult object.  All</span></div>
<div class="line"><a id="l01236" name="l01236"></a><span class="lineno"> 1236</span>  <span class="comment">// Google Test assertion macros (e.g. ASSERT_TRUE, EXPECT_EQ, etc)</span></div>
<div class="line"><a id="l01237" name="l01237"></a><span class="lineno"> 1237</span>  <span class="comment">// eventually call this to report their results.  The user code</span></div>
<div class="line"><a id="l01238" name="l01238"></a><span class="lineno"> 1238</span>  <span class="comment">// should use the assertion macros instead of calling this directly.</span></div>
<div class="line"><a id="l01239" name="l01239"></a><span class="lineno"> 1239</span>  <span class="keywordtype">void</span> AddTestPartResult(TestPartResult::Type result_type,</div>
<div class="line"><a id="l01240" name="l01240"></a><span class="lineno"> 1240</span>                         <span class="keyword">const</span> <span class="keywordtype">char</span>* file_name, <span class="keywordtype">int</span> line_number,</div>
<div class="line"><a id="l01241" name="l01241"></a><span class="lineno"> 1241</span>                         <span class="keyword">const</span> std::string&amp; message,</div>
<div class="line"><a id="l01242" name="l01242"></a><span class="lineno"> 1242</span>                         <span class="keyword">const</span> std::string&amp; os_stack_trace)</div>
<div class="line"><a id="l01243" name="l01243"></a><span class="lineno"> 1243</span>      GTEST_LOCK_EXCLUDED_(mutex_);</div>
<div class="line"><a id="l01244" name="l01244"></a><span class="lineno"> 1244</span> </div>
<div class="line"><a id="l01245" name="l01245"></a><span class="lineno"> 1245</span>  <span class="comment">// Adds a TestProperty to the current TestResult object when invoked from</span></div>
<div class="line"><a id="l01246" name="l01246"></a><span class="lineno"> 1246</span>  <span class="comment">// inside a test, to current TestSuite&#39;s ad_hoc_test_result_ when invoked</span></div>
<div class="line"><a id="l01247" name="l01247"></a><span class="lineno"> 1247</span>  <span class="comment">// from SetUpTestSuite or TearDownTestSuite, or to the global property set</span></div>
<div class="line"><a id="l01248" name="l01248"></a><span class="lineno"> 1248</span>  <span class="comment">// when invoked elsewhere.  If the result already contains a property with</span></div>
<div class="line"><a id="l01249" name="l01249"></a><span class="lineno"> 1249</span>  <span class="comment">// the same key, the value will be updated.</span></div>
<div class="line"><a id="l01250" name="l01250"></a><span class="lineno"> 1250</span>  <span class="keywordtype">void</span> RecordProperty(<span class="keyword">const</span> std::string&amp; key, <span class="keyword">const</span> std::string&amp; value);</div>
<div class="line"><a id="l01251" name="l01251"></a><span class="lineno"> 1251</span> </div>
<div class="line"><a id="l01252" name="l01252"></a><span class="lineno"> 1252</span>  <span class="comment">// Gets the i-th test suite among all the test suites. i can range from 0 to</span></div>
<div class="line"><a id="l01253" name="l01253"></a><span class="lineno"> 1253</span>  <span class="comment">// total_test_suite_count() - 1. If i is not in that range, returns NULL.</span></div>
<div class="line"><a id="l01254" name="l01254"></a><span class="lineno"> 1254</span>  <a class="code hl_class" href="classtesting_1_1_test_suite.html">TestSuite</a>* GetMutableTestSuite(<span class="keywordtype">int</span> i);</div>
<div class="line"><a id="l01255" name="l01255"></a><span class="lineno"> 1255</span> </div>
<div class="line"><a id="l01256" name="l01256"></a><span class="lineno"> 1256</span>  <span class="comment">// Accessors for the implementation object.</span></div>
<div class="line"><a id="l01257" name="l01257"></a><span class="lineno"> 1257</span>  <a class="code hl_class" href="classtesting_1_1internal_1_1_unit_test_impl.html">internal::UnitTestImpl</a>* impl() { <span class="keywordflow">return</span> impl_; }</div>
<div class="line"><a id="l01258" name="l01258"></a><span class="lineno"> 1258</span>  <span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1internal_1_1_unit_test_impl.html">internal::UnitTestImpl</a>* impl()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> impl_; }</div>
<div class="line"><a id="l01259" name="l01259"></a><span class="lineno"> 1259</span> </div>
<div class="line"><a id="l01260" name="l01260"></a><span class="lineno"> 1260</span>  <span class="comment">// These classes and functions are friends as they need to access private</span></div>
<div class="line"><a id="l01261" name="l01261"></a><span class="lineno"> 1261</span>  <span class="comment">// members of UnitTest.</span></div>
<div class="line"><a id="l01262" name="l01262"></a><span class="lineno"> 1262</span>  <span class="keyword">friend</span> <span class="keyword">class </span>ScopedTrace;</div>
<div class="line"><a id="l01263" name="l01263"></a><span class="lineno"> 1263</span>  <span class="keyword">friend</span> <span class="keyword">class </span>Test;</div>
<div class="line"><a id="l01264" name="l01264"></a><span class="lineno"> 1264</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_assert_helper.html">internal::AssertHelper</a>;</div>
<div class="line"><a id="l01265" name="l01265"></a><span class="lineno"> 1265</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::StreamingListenerTest;</div>
<div class="line"><a id="l01266" name="l01266"></a><span class="lineno"> 1266</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_unit_test_record_property_test_helper.html">internal::UnitTestRecordPropertyTestHelper</a>;</div>
<div class="line"><a id="l01267" name="l01267"></a><span class="lineno"> 1267</span>  <span class="keyword">friend</span> <a class="code hl_class" href="classtesting_1_1_environment.html">Environment</a>* AddGlobalTestEnvironment(<a class="code hl_class" href="classtesting_1_1_environment.html">Environment</a>* env);</div>
<div class="line"><a id="l01268" name="l01268"></a><span class="lineno"> 1268</span>  <span class="keyword">friend</span> std::set&lt;std::string&gt;* internal::GetIgnoredParameterizedTestSuites();</div>
<div class="line"><a id="l01269" name="l01269"></a><span class="lineno"> 1269</span>  <span class="keyword">friend</span> <a class="code hl_class" href="classtesting_1_1internal_1_1_unit_test_impl.html">internal::UnitTestImpl</a>* internal::GetUnitTestImpl();</div>
<div class="line"><a id="l01270" name="l01270"></a><span class="lineno"> 1270</span>  <span class="keyword">friend</span> <span class="keywordtype">void</span> internal::ReportFailureInUnknownLocation(</div>
<div class="line"><a id="l01271" name="l01271"></a><span class="lineno"> 1271</span>      TestPartResult::Type result_type, <span class="keyword">const</span> std::string&amp; message);</div>
<div class="line"><a id="l01272" name="l01272"></a><span class="lineno"> 1272</span> </div>
<div class="line"><a id="l01273" name="l01273"></a><span class="lineno"> 1273</span>  <span class="comment">// Creates an empty UnitTest.</span></div>
<div class="line"><a id="l01274" name="l01274"></a><span class="lineno"> 1274</span>  UnitTest();</div>
<div class="line"><a id="l01275" name="l01275"></a><span class="lineno"> 1275</span> </div>
<div class="line"><a id="l01276" name="l01276"></a><span class="lineno"> 1276</span>  <span class="comment">// D&#39;tor</span></div>
<div class="line"><a id="l01277" name="l01277"></a><span class="lineno"> 1277</span>  <span class="keyword">virtual</span> ~UnitTest();</div>
<div class="line"><a id="l01278" name="l01278"></a><span class="lineno"> 1278</span> </div>
<div class="line"><a id="l01279" name="l01279"></a><span class="lineno"> 1279</span>  <span class="comment">// Pushes a trace defined by SCOPED_TRACE() on to the per-thread</span></div>
<div class="line"><a id="l01280" name="l01280"></a><span class="lineno"> 1280</span>  <span class="comment">// Google Test trace stack.</span></div>
<div class="line"><a id="l01281" name="l01281"></a><span class="lineno"> 1281</span>  <span class="keywordtype">void</span> PushGTestTrace(<span class="keyword">const</span> <a class="code hl_struct" href="structtesting_1_1internal_1_1_trace_info.html">internal::TraceInfo</a>&amp; trace)</div>
<div class="line"><a id="l01282" name="l01282"></a><span class="lineno"> 1282</span>      GTEST_LOCK_EXCLUDED_(mutex_);</div>
<div class="line"><a id="l01283" name="l01283"></a><span class="lineno"> 1283</span> </div>
<div class="line"><a id="l01284" name="l01284"></a><span class="lineno"> 1284</span>  <span class="comment">// Pops a trace from the per-thread Google Test trace stack.</span></div>
<div class="line"><a id="l01285" name="l01285"></a><span class="lineno"> 1285</span>  <span class="keywordtype">void</span> PopGTestTrace() GTEST_LOCK_EXCLUDED_(mutex_);</div>
<div class="line"><a id="l01286" name="l01286"></a><span class="lineno"> 1286</span> </div>
<div class="line"><a id="l01287" name="l01287"></a><span class="lineno"> 1287</span>  <span class="comment">// Protects mutable state in *impl_.  This is mutable as some const</span></div>
<div class="line"><a id="l01288" name="l01288"></a><span class="lineno"> 1288</span>  <span class="comment">// methods need to lock it too.</span></div>
<div class="line"><a id="l01289" name="l01289"></a><span class="lineno"> 1289</span>  <span class="keyword">mutable</span> <a class="code hl_class" href="classtesting_1_1internal_1_1_mutex.html">internal::Mutex</a> mutex_;</div>
<div class="line"><a id="l01290" name="l01290"></a><span class="lineno"> 1290</span> </div>
<div class="line"><a id="l01291" name="l01291"></a><span class="lineno"> 1291</span>  <span class="comment">// Opaque implementation object.  This field is never changed once</span></div>
<div class="line"><a id="l01292" name="l01292"></a><span class="lineno"> 1292</span>  <span class="comment">// the object is constructed.  We don&#39;t mark it as const here, as</span></div>
<div class="line"><a id="l01293" name="l01293"></a><span class="lineno"> 1293</span>  <span class="comment">// doing so will cause a warning in the constructor of UnitTest.</span></div>
<div class="line"><a id="l01294" name="l01294"></a><span class="lineno"> 1294</span>  <span class="comment">// Mutable state in *impl_ is protected by mutex_.</span></div>
<div class="line"><a id="l01295" name="l01295"></a><span class="lineno"> 1295</span>  <a class="code hl_class" href="classtesting_1_1internal_1_1_unit_test_impl.html">internal::UnitTestImpl</a>* impl_;</div>
<div class="line"><a id="l01296" name="l01296"></a><span class="lineno"> 1296</span> </div>
<div class="line"><a id="l01297" name="l01297"></a><span class="lineno"> 1297</span>  <span class="comment">// We disallow copying UnitTest.</span></div>
<div class="line"><a id="l01298" name="l01298"></a><span class="lineno"> 1298</span>  UnitTest(<span class="keyword">const</span> UnitTest&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01299" name="l01299"></a><span class="lineno"> 1299</span>  UnitTest&amp; operator=(<span class="keyword">const</span> UnitTest&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01300" name="l01300"></a><span class="lineno"> 1300</span>};</div>
</div>
<div class="line"><a id="l01301" name="l01301"></a><span class="lineno"> 1301</span> </div>
<div class="line"><a id="l01302" name="l01302"></a><span class="lineno"> 1302</span><span class="comment">// A convenient wrapper for adding an environment for the test</span></div>
<div class="line"><a id="l01303" name="l01303"></a><span class="lineno"> 1303</span><span class="comment">// program.</span></div>
<div class="line"><a id="l01304" name="l01304"></a><span class="lineno"> 1304</span><span class="comment">//</span></div>
<div class="line"><a id="l01305" name="l01305"></a><span class="lineno"> 1305</span><span class="comment">// You should call this before RUN_ALL_TESTS() is called, probably in</span></div>
<div class="line"><a id="l01306" name="l01306"></a><span class="lineno"> 1306</span><span class="comment">// main().  If you use gtest_main, you need to call this before main()</span></div>
<div class="line"><a id="l01307" name="l01307"></a><span class="lineno"> 1307</span><span class="comment">// starts for it to take effect.  For example, you can define a global</span></div>
<div class="line"><a id="l01308" name="l01308"></a><span class="lineno"> 1308</span><span class="comment">// variable like this:</span></div>
<div class="line"><a id="l01309" name="l01309"></a><span class="lineno"> 1309</span><span class="comment">//</span></div>
<div class="line"><a id="l01310" name="l01310"></a><span class="lineno"> 1310</span><span class="comment">//   testing::Environment* const foo_env =</span></div>
<div class="line"><a id="l01311" name="l01311"></a><span class="lineno"> 1311</span><span class="comment">//       testing::AddGlobalTestEnvironment(new FooEnvironment);</span></div>
<div class="line"><a id="l01312" name="l01312"></a><span class="lineno"> 1312</span><span class="comment">//</span></div>
<div class="line"><a id="l01313" name="l01313"></a><span class="lineno"> 1313</span><span class="comment">// However, we strongly recommend you to write your own main() and</span></div>
<div class="line"><a id="l01314" name="l01314"></a><span class="lineno"> 1314</span><span class="comment">// call AddGlobalTestEnvironment() there, as relying on initialization</span></div>
<div class="line"><a id="l01315" name="l01315"></a><span class="lineno"> 1315</span><span class="comment">// of global variables makes the code harder to read and may cause</span></div>
<div class="line"><a id="l01316" name="l01316"></a><span class="lineno"> 1316</span><span class="comment">// problems when you register multiple environments from different</span></div>
<div class="line"><a id="l01317" name="l01317"></a><span class="lineno"> 1317</span><span class="comment">// translation units and the environments have dependencies among them</span></div>
<div class="line"><a id="l01318" name="l01318"></a><span class="lineno"> 1318</span><span class="comment">// (remember that the compiler doesn&#39;t guarantee the order in which</span></div>
<div class="line"><a id="l01319" name="l01319"></a><span class="lineno"> 1319</span><span class="comment">// global variables from different translation units are initialized).</span></div>
<div class="line"><a id="l01320" name="l01320"></a><span class="lineno"> 1320</span><span class="keyword">inline</span> <a class="code hl_class" href="classtesting_1_1_environment.html">Environment</a>* AddGlobalTestEnvironment(<a class="code hl_class" href="classtesting_1_1_environment.html">Environment</a>* env) {</div>
<div class="line"><a id="l01321" name="l01321"></a><span class="lineno"> 1321</span>  <span class="keywordflow">return</span> UnitTest::GetInstance()-&gt;AddEnvironment(env);</div>
<div class="line"><a id="l01322" name="l01322"></a><span class="lineno"> 1322</span>}</div>
<div class="line"><a id="l01323" name="l01323"></a><span class="lineno"> 1323</span> </div>
<div class="line"><a id="l01324" name="l01324"></a><span class="lineno"> 1324</span><span class="comment">// Initializes Google Test.  This must be called before calling</span></div>
<div class="line"><a id="l01325" name="l01325"></a><span class="lineno"> 1325</span><span class="comment">// RUN_ALL_TESTS().  In particular, it parses a command line for the</span></div>
<div class="line"><a id="l01326" name="l01326"></a><span class="lineno"> 1326</span><span class="comment">// flags that Google Test recognizes.  Whenever a Google Test flag is</span></div>
<div class="line"><a id="l01327" name="l01327"></a><span class="lineno"> 1327</span><span class="comment">// seen, it is removed from argv, and *argc is decremented.</span></div>
<div class="line"><a id="l01328" name="l01328"></a><span class="lineno"> 1328</span><span class="comment">//</span></div>
<div class="line"><a id="l01329" name="l01329"></a><span class="lineno"> 1329</span><span class="comment">// No value is returned.  Instead, the Google Test flag variables are</span></div>
<div class="line"><a id="l01330" name="l01330"></a><span class="lineno"> 1330</span><span class="comment">// updated.</span></div>
<div class="line"><a id="l01331" name="l01331"></a><span class="lineno"> 1331</span><span class="comment">//</span></div>
<div class="line"><a id="l01332" name="l01332"></a><span class="lineno"> 1332</span><span class="comment">// Calling the function for the second time has no user-visible effect.</span></div>
<div class="line"><a id="l01333" name="l01333"></a><span class="lineno"> 1333</span>GTEST_API_ <span class="keywordtype">void</span> InitGoogleTest(<span class="keywordtype">int</span>* argc, <span class="keywordtype">char</span>** argv);</div>
<div class="line"><a id="l01334" name="l01334"></a><span class="lineno"> 1334</span> </div>
<div class="line"><a id="l01335" name="l01335"></a><span class="lineno"> 1335</span><span class="comment">// This overloaded version can be used in Windows programs compiled in</span></div>
<div class="line"><a id="l01336" name="l01336"></a><span class="lineno"> 1336</span><span class="comment">// UNICODE mode.</span></div>
<div class="line"><a id="l01337" name="l01337"></a><span class="lineno"> 1337</span>GTEST_API_ <span class="keywordtype">void</span> InitGoogleTest(<span class="keywordtype">int</span>* argc, <span class="keywordtype">wchar_t</span>** argv);</div>
<div class="line"><a id="l01338" name="l01338"></a><span class="lineno"> 1338</span> </div>
<div class="line"><a id="l01339" name="l01339"></a><span class="lineno"> 1339</span><span class="comment">// This overloaded version can be used on Arduino/embedded platforms where</span></div>
<div class="line"><a id="l01340" name="l01340"></a><span class="lineno"> 1340</span><span class="comment">// there is no argc/argv.</span></div>
<div class="line"><a id="l01341" name="l01341"></a><span class="lineno"> 1341</span>GTEST_API_ <span class="keywordtype">void</span> InitGoogleTest();</div>
<div class="line"><a id="l01342" name="l01342"></a><span class="lineno"> 1342</span> </div>
<div class="line"><a id="l01343" name="l01343"></a><span class="lineno"> 1343</span><span class="keyword">namespace </span>internal {</div>
<div class="line"><a id="l01344" name="l01344"></a><span class="lineno"> 1344</span> </div>
<div class="line"><a id="l01345" name="l01345"></a><span class="lineno"> 1345</span><span class="comment">// Separate the error generating code from the code path to reduce the stack</span></div>
<div class="line"><a id="l01346" name="l01346"></a><span class="lineno"> 1346</span><span class="comment">// frame size of CmpHelperEQ. This helps reduce the overhead of some sanitizers</span></div>
<div class="line"><a id="l01347" name="l01347"></a><span class="lineno"> 1347</span><span class="comment">// when calling EXPECT_* in a tight loop.</span></div>
<div class="line"><a id="l01348" name="l01348"></a><span class="lineno"> 1348</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T1, <span class="keyword">typename</span> T2&gt;</div>
<div class="line"><a id="l01349" name="l01349"></a><span class="lineno"> 1349</span>AssertionResult CmpHelperEQFailure(<span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
<div class="line"><a id="l01350" name="l01350"></a><span class="lineno"> 1350</span>                                   <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression, <span class="keyword">const</span> T1&amp; lhs,</div>
<div class="line"><a id="l01351" name="l01351"></a><span class="lineno"> 1351</span>                                   <span class="keyword">const</span> T2&amp; rhs) {</div>
<div class="line"><a id="l01352" name="l01352"></a><span class="lineno"> 1352</span>  <span class="keywordflow">return</span> EqFailure(lhs_expression, rhs_expression,</div>
<div class="line"><a id="l01353" name="l01353"></a><span class="lineno"> 1353</span>                   FormatForComparisonFailureMessage(lhs, rhs),</div>
<div class="line"><a id="l01354" name="l01354"></a><span class="lineno"> 1354</span>                   FormatForComparisonFailureMessage(rhs, lhs), <span class="keyword">false</span>);</div>
<div class="line"><a id="l01355" name="l01355"></a><span class="lineno"> 1355</span>}</div>
<div class="line"><a id="l01356" name="l01356"></a><span class="lineno"> 1356</span> </div>
<div class="line"><a id="l01357" name="l01357"></a><span class="lineno"> 1357</span><span class="comment">// This block of code defines operator==/!=</span></div>
<div class="line"><a id="l01358" name="l01358"></a><span class="lineno"> 1358</span><span class="comment">// to block lexical scope lookup.</span></div>
<div class="line"><a id="l01359" name="l01359"></a><span class="lineno"> 1359</span><span class="comment">// It prevents using invalid operator==/!= defined at namespace scope.</span></div>
<div class="line"><a id="l01360" name="l01360"></a><span class="lineno"><a class="line" href="structtesting_1_1internal_1_1faketype.html"> 1360</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structtesting_1_1internal_1_1faketype.html">faketype</a> {};</div>
<div class="line"><a id="l01361" name="l01361"></a><span class="lineno"> 1361</span><span class="keyword">inline</span> <span class="keywordtype">bool</span> operator==(<a class="code hl_struct" href="structtesting_1_1internal_1_1faketype.html">faketype</a>, <a class="code hl_struct" href="structtesting_1_1internal_1_1faketype.html">faketype</a>) { <span class="keywordflow">return</span> <span class="keyword">true</span>; }</div>
<div class="line"><a id="l01362" name="l01362"></a><span class="lineno"> 1362</span><span class="keyword">inline</span> <span class="keywordtype">bool</span> operator!=(faketype, faketype) { <span class="keywordflow">return</span> <span class="keyword">false</span>; }</div>
<div class="line"><a id="l01363" name="l01363"></a><span class="lineno"> 1363</span> </div>
<div class="line"><a id="l01364" name="l01364"></a><span class="lineno"> 1364</span><span class="comment">// The helper function for {ASSERT|EXPECT}_EQ.</span></div>
<div class="line"><a id="l01365" name="l01365"></a><span class="lineno"> 1365</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T1, <span class="keyword">typename</span> T2&gt;</div>
<div class="line"><a id="l01366" name="l01366"></a><span class="lineno"> 1366</span>AssertionResult CmpHelperEQ(<span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
<div class="line"><a id="l01367" name="l01367"></a><span class="lineno"> 1367</span>                            <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression, <span class="keyword">const</span> T1&amp; lhs,</div>
<div class="line"><a id="l01368" name="l01368"></a><span class="lineno"> 1368</span>                            <span class="keyword">const</span> T2&amp; rhs) {</div>
<div class="line"><a id="l01369" name="l01369"></a><span class="lineno"> 1369</span>  <span class="keywordflow">if</span> (lhs == rhs) {</div>
<div class="line"><a id="l01370" name="l01370"></a><span class="lineno"> 1370</span>    <span class="keywordflow">return</span> AssertionSuccess();</div>
<div class="line"><a id="l01371" name="l01371"></a><span class="lineno"> 1371</span>  }</div>
<div class="line"><a id="l01372" name="l01372"></a><span class="lineno"> 1372</span> </div>
<div class="line"><a id="l01373" name="l01373"></a><span class="lineno"> 1373</span>  <span class="keywordflow">return</span> CmpHelperEQFailure(lhs_expression, rhs_expression, lhs, rhs);</div>
<div class="line"><a id="l01374" name="l01374"></a><span class="lineno"> 1374</span>}</div>
<div class="line"><a id="l01375" name="l01375"></a><span class="lineno"> 1375</span> </div>
<div class="foldopen" id="foldopen01376" data-start="{" data-end="};">
<div class="line"><a id="l01376" name="l01376"></a><span class="lineno"><a class="line" href="classtesting_1_1internal_1_1_eq_helper.html"> 1376</a></span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_eq_helper.html">EqHelper</a> {</div>
<div class="line"><a id="l01377" name="l01377"></a><span class="lineno"> 1377</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01378" name="l01378"></a><span class="lineno"> 1378</span>  <span class="comment">// This templatized version is for the general case.</span></div>
<div class="line"><a id="l01379" name="l01379"></a><span class="lineno"> 1379</span>  <span class="keyword">template</span> &lt;</div>
<div class="line"><a id="l01380" name="l01380"></a><span class="lineno"> 1380</span>      <span class="keyword">typename</span> T1, <span class="keyword">typename</span> T2,</div>
<div class="line"><a id="l01381" name="l01381"></a><span class="lineno"> 1381</span>      <span class="comment">// Disable this overload for cases where one argument is a pointer</span></div>
<div class="line"><a id="l01382" name="l01382"></a><span class="lineno"> 1382</span>      <span class="comment">// and the other is the null pointer constant.</span></div>
<div class="line"><a id="l01383" name="l01383"></a><span class="lineno"> 1383</span>      <span class="keyword">typename</span> std::enable_if&lt;!std::is_integral&lt;T1&gt;::value ||</div>
<div class="line"><a id="l01384" name="l01384"></a><span class="lineno"> 1384</span>                              !std::is_pointer&lt;T2&gt;::value&gt;::type* = <span class="keyword">nullptr</span>&gt;</div>
<div class="line"><a id="l01385" name="l01385"></a><span class="lineno"> 1385</span>  <span class="keyword">static</span> AssertionResult Compare(<span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
<div class="line"><a id="l01386" name="l01386"></a><span class="lineno"> 1386</span>                                 <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression, <span class="keyword">const</span> T1&amp; lhs,</div>
<div class="line"><a id="l01387" name="l01387"></a><span class="lineno"> 1387</span>                                 <span class="keyword">const</span> T2&amp; rhs) {</div>
<div class="line"><a id="l01388" name="l01388"></a><span class="lineno"> 1388</span>    <span class="keywordflow">return</span> CmpHelperEQ(lhs_expression, rhs_expression, lhs, rhs);</div>
<div class="line"><a id="l01389" name="l01389"></a><span class="lineno"> 1389</span>  }</div>
<div class="line"><a id="l01390" name="l01390"></a><span class="lineno"> 1390</span> </div>
<div class="line"><a id="l01391" name="l01391"></a><span class="lineno"> 1391</span>  <span class="comment">// With this overloaded version, we allow anonymous enums to be used</span></div>
<div class="line"><a id="l01392" name="l01392"></a><span class="lineno"> 1392</span>  <span class="comment">// in {ASSERT|EXPECT}_EQ when compiled with gcc 4, as anonymous</span></div>
<div class="line"><a id="l01393" name="l01393"></a><span class="lineno"> 1393</span>  <span class="comment">// enums can be implicitly cast to BiggestInt.</span></div>
<div class="line"><a id="l01394" name="l01394"></a><span class="lineno"> 1394</span>  <span class="comment">//</span></div>
<div class="line"><a id="l01395" name="l01395"></a><span class="lineno"> 1395</span>  <span class="comment">// Even though its body looks the same as the above version, we</span></div>
<div class="line"><a id="l01396" name="l01396"></a><span class="lineno"> 1396</span>  <span class="comment">// cannot merge the two, as it will make anonymous enums unhappy.</span></div>
<div class="line"><a id="l01397" name="l01397"></a><span class="lineno"> 1397</span>  <span class="keyword">static</span> AssertionResult Compare(<span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
<div class="line"><a id="l01398" name="l01398"></a><span class="lineno"> 1398</span>                                 <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression, BiggestInt lhs,</div>
<div class="line"><a id="l01399" name="l01399"></a><span class="lineno"> 1399</span>                                 BiggestInt rhs) {</div>
<div class="line"><a id="l01400" name="l01400"></a><span class="lineno"> 1400</span>    <span class="keywordflow">return</span> CmpHelperEQ(lhs_expression, rhs_expression, lhs, rhs);</div>
<div class="line"><a id="l01401" name="l01401"></a><span class="lineno"> 1401</span>  }</div>
<div class="line"><a id="l01402" name="l01402"></a><span class="lineno"> 1402</span> </div>
<div class="line"><a id="l01403" name="l01403"></a><span class="lineno"> 1403</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt;</div>
<div class="line"><a id="l01404" name="l01404"></a><span class="lineno"> 1404</span>  <span class="keyword">static</span> AssertionResult Compare(</div>
<div class="line"><a id="l01405" name="l01405"></a><span class="lineno"> 1405</span>      <span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression, <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression,</div>
<div class="line"><a id="l01406" name="l01406"></a><span class="lineno"> 1406</span>      <span class="comment">// Handle cases where &#39;0&#39; is used as a null pointer literal.</span></div>
<div class="line"><a id="l01407" name="l01407"></a><span class="lineno"> 1407</span>      std::nullptr_t <span class="comment">/* lhs */</span>, T* rhs) {</div>
<div class="line"><a id="l01408" name="l01408"></a><span class="lineno"> 1408</span>    <span class="comment">// We already know that &#39;lhs&#39; is a null pointer.</span></div>
<div class="line"><a id="l01409" name="l01409"></a><span class="lineno"> 1409</span>    <span class="keywordflow">return</span> CmpHelperEQ(lhs_expression, rhs_expression, <span class="keyword">static_cast&lt;</span>T*<span class="keyword">&gt;</span>(<span class="keyword">nullptr</span>),</div>
<div class="line"><a id="l01410" name="l01410"></a><span class="lineno"> 1410</span>                       rhs);</div>
<div class="line"><a id="l01411" name="l01411"></a><span class="lineno"> 1411</span>  }</div>
<div class="line"><a id="l01412" name="l01412"></a><span class="lineno"> 1412</span>};</div>
</div>
<div class="line"><a id="l01413" name="l01413"></a><span class="lineno"> 1413</span> </div>
<div class="line"><a id="l01414" name="l01414"></a><span class="lineno"> 1414</span><span class="comment">// Separate the error generating code from the code path to reduce the stack</span></div>
<div class="line"><a id="l01415" name="l01415"></a><span class="lineno"> 1415</span><span class="comment">// frame size of CmpHelperOP. This helps reduce the overhead of some sanitizers</span></div>
<div class="line"><a id="l01416" name="l01416"></a><span class="lineno"> 1416</span><span class="comment">// when calling EXPECT_OP in a tight loop.</span></div>
<div class="line"><a id="l01417" name="l01417"></a><span class="lineno"> 1417</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T1, <span class="keyword">typename</span> T2&gt;</div>
<div class="line"><a id="l01418" name="l01418"></a><span class="lineno"> 1418</span>AssertionResult CmpHelperOpFailure(<span class="keyword">const</span> <span class="keywordtype">char</span>* expr1, <span class="keyword">const</span> <span class="keywordtype">char</span>* expr2,</div>
<div class="line"><a id="l01419" name="l01419"></a><span class="lineno"> 1419</span>                                   <span class="keyword">const</span> T1&amp; val1, <span class="keyword">const</span> T2&amp; val2,</div>
<div class="line"><a id="l01420" name="l01420"></a><span class="lineno"> 1420</span>                                   <span class="keyword">const</span> <span class="keywordtype">char</span>* op) {</div>
<div class="line"><a id="l01421" name="l01421"></a><span class="lineno"> 1421</span>  <span class="keywordflow">return</span> AssertionFailure()</div>
<div class="line"><a id="l01422" name="l01422"></a><span class="lineno"> 1422</span>         &lt;&lt; <span class="stringliteral">&quot;Expected: (&quot;</span> &lt;&lt; expr1 &lt;&lt; <span class="stringliteral">&quot;) &quot;</span> &lt;&lt; op &lt;&lt; <span class="stringliteral">&quot; (&quot;</span> &lt;&lt; expr2</div>
<div class="line"><a id="l01423" name="l01423"></a><span class="lineno"> 1423</span>         &lt;&lt; <span class="stringliteral">&quot;), actual: &quot;</span> &lt;&lt; FormatForComparisonFailureMessage(val1, val2)</div>
<div class="line"><a id="l01424" name="l01424"></a><span class="lineno"> 1424</span>         &lt;&lt; <span class="stringliteral">&quot; vs &quot;</span> &lt;&lt; FormatForComparisonFailureMessage(val2, val1);</div>
<div class="line"><a id="l01425" name="l01425"></a><span class="lineno"> 1425</span>}</div>
<div class="line"><a id="l01426" name="l01426"></a><span class="lineno"> 1426</span> </div>
<div class="line"><a id="l01427" name="l01427"></a><span class="lineno"> 1427</span><span class="comment">// A macro for implementing the helper functions needed to implement</span></div>
<div class="line"><a id="l01428" name="l01428"></a><span class="lineno"> 1428</span><span class="comment">// ASSERT_?? and EXPECT_??.  It is here just to avoid copy-and-paste</span></div>
<div class="line"><a id="l01429" name="l01429"></a><span class="lineno"> 1429</span><span class="comment">// of similar code.</span></div>
<div class="line"><a id="l01430" name="l01430"></a><span class="lineno"> 1430</span><span class="comment">//</span></div>
<div class="line"><a id="l01431" name="l01431"></a><span class="lineno"> 1431</span><span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01432" name="l01432"></a><span class="lineno"> 1432</span> </div>
<div class="line"><a id="l01433" name="l01433"></a><span class="lineno"> 1433</span><span class="preprocessor">#define GTEST_IMPL_CMP_HELPER_(op_name, op)                                \</span></div>
<div class="line"><a id="l01434" name="l01434"></a><span class="lineno"> 1434</span><span class="preprocessor">  template &lt;typename T1, typename T2&gt;                                      \</span></div>
<div class="line"><a id="l01435" name="l01435"></a><span class="lineno"> 1435</span><span class="preprocessor">  AssertionResult CmpHelper##op_name(const char* expr1, const char* expr2, \</span></div>
<div class="line"><a id="l01436" name="l01436"></a><span class="lineno"> 1436</span><span class="preprocessor">                                     const T1&amp; val1, const T2&amp; val2) {     \</span></div>
<div class="line"><a id="l01437" name="l01437"></a><span class="lineno"> 1437</span><span class="preprocessor">    if (val1 op val2) {                                                    \</span></div>
<div class="line"><a id="l01438" name="l01438"></a><span class="lineno"> 1438</span><span class="preprocessor">      return AssertionSuccess();                                           \</span></div>
<div class="line"><a id="l01439" name="l01439"></a><span class="lineno"> 1439</span><span class="preprocessor">    } else {                                                               \</span></div>
<div class="line"><a id="l01440" name="l01440"></a><span class="lineno"> 1440</span><span class="preprocessor">      return CmpHelperOpFailure(expr1, expr2, val1, val2, #op);            \</span></div>
<div class="line"><a id="l01441" name="l01441"></a><span class="lineno"> 1441</span><span class="preprocessor">    }                                                                      \</span></div>
<div class="line"><a id="l01442" name="l01442"></a><span class="lineno"> 1442</span><span class="preprocessor">  }</span></div>
<div class="line"><a id="l01443" name="l01443"></a><span class="lineno"> 1443</span> </div>
<div class="line"><a id="l01444" name="l01444"></a><span class="lineno"> 1444</span><span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01445" name="l01445"></a><span class="lineno"> 1445</span> </div>
<div class="line"><a id="l01446" name="l01446"></a><span class="lineno"> 1446</span><span class="comment">// Implements the helper function for {ASSERT|EXPECT}_NE</span></div>
<div class="line"><a id="l01447" name="l01447"></a><span class="lineno"> 1447</span>GTEST_IMPL_CMP_HELPER_(NE, !=)</div>
<div class="line"><a id="l01448" name="l01448"></a><span class="lineno"> 1448</span><span class="comment">// Implements the helper function for {ASSERT|EXPECT}_LE</span></div>
<div class="line"><a id="l01449" name="l01449"></a><span class="lineno"> 1449</span>GTEST_IMPL_CMP_HELPER_(LE, &lt;=)</div>
<div class="line"><a id="l01450" name="l01450"></a><span class="lineno"> 1450</span><span class="comment">// Implements the helper function for {ASSERT|EXPECT}_LT</span></div>
<div class="line"><a id="l01451" name="l01451"></a><span class="lineno"> 1451</span>GTEST_IMPL_CMP_HELPER_(LT, &lt;)</div>
<div class="line"><a id="l01452" name="l01452"></a><span class="lineno"> 1452</span><span class="comment">// Implements the helper function for {ASSERT|EXPECT}_GE</span></div>
<div class="line"><a id="l01453" name="l01453"></a><span class="lineno"> 1453</span>GTEST_IMPL_CMP_HELPER_(GE, &gt;=)</div>
<div class="line"><a id="l01454" name="l01454"></a><span class="lineno"> 1454</span><span class="comment">// Implements the helper function for {ASSERT|EXPECT}_GT</span></div>
<div class="line"><a id="l01455" name="l01455"></a><span class="lineno"> 1455</span>GTEST_IMPL_CMP_HELPER_(GT, &gt;)</div>
<div class="line"><a id="l01456" name="l01456"></a><span class="lineno"> 1456</span> </div>
<div class="line"><a id="l01457" name="l01457"></a><span class="lineno"> 1457</span><span class="preprocessor">#undef GTEST_IMPL_CMP_HELPER_</span></div>
<div class="line"><a id="l01458" name="l01458"></a><span class="lineno"> 1458</span> </div>
<div class="line"><a id="l01459" name="l01459"></a><span class="lineno"> 1459</span><span class="comment">// The helper function for {ASSERT|EXPECT}_STREQ.</span></div>
<div class="line"><a id="l01460" name="l01460"></a><span class="lineno"> 1460</span><span class="comment">//</span></div>
<div class="line"><a id="l01461" name="l01461"></a><span class="lineno"> 1461</span><span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01462" name="l01462"></a><span class="lineno"> 1462</span>GTEST_API_ AssertionResult CmpHelperSTREQ(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
<div class="line"><a id="l01463" name="l01463"></a><span class="lineno"> 1463</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
<div class="line"><a id="l01464" name="l01464"></a><span class="lineno"> 1464</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* s1, <span class="keyword">const</span> <span class="keywordtype">char</span>* s2);</div>
<div class="line"><a id="l01465" name="l01465"></a><span class="lineno"> 1465</span> </div>
<div class="line"><a id="l01466" name="l01466"></a><span class="lineno"> 1466</span><span class="comment">// The helper function for {ASSERT|EXPECT}_STRCASEEQ.</span></div>
<div class="line"><a id="l01467" name="l01467"></a><span class="lineno"> 1467</span><span class="comment">//</span></div>
<div class="line"><a id="l01468" name="l01468"></a><span class="lineno"> 1468</span><span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01469" name="l01469"></a><span class="lineno"> 1469</span>GTEST_API_ AssertionResult CmpHelperSTRCASEEQ(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
<div class="line"><a id="l01470" name="l01470"></a><span class="lineno"> 1470</span>                                              <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
<div class="line"><a id="l01471" name="l01471"></a><span class="lineno"> 1471</span>                                              <span class="keyword">const</span> <span class="keywordtype">char</span>* s1, <span class="keyword">const</span> <span class="keywordtype">char</span>* s2);</div>
<div class="line"><a id="l01472" name="l01472"></a><span class="lineno"> 1472</span> </div>
<div class="line"><a id="l01473" name="l01473"></a><span class="lineno"> 1473</span><span class="comment">// The helper function for {ASSERT|EXPECT}_STRNE.</span></div>
<div class="line"><a id="l01474" name="l01474"></a><span class="lineno"> 1474</span><span class="comment">//</span></div>
<div class="line"><a id="l01475" name="l01475"></a><span class="lineno"> 1475</span><span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01476" name="l01476"></a><span class="lineno"> 1476</span>GTEST_API_ AssertionResult CmpHelperSTRNE(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
<div class="line"><a id="l01477" name="l01477"></a><span class="lineno"> 1477</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
<div class="line"><a id="l01478" name="l01478"></a><span class="lineno"> 1478</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* s1, <span class="keyword">const</span> <span class="keywordtype">char</span>* s2);</div>
<div class="line"><a id="l01479" name="l01479"></a><span class="lineno"> 1479</span> </div>
<div class="line"><a id="l01480" name="l01480"></a><span class="lineno"> 1480</span><span class="comment">// The helper function for {ASSERT|EXPECT}_STRCASENE.</span></div>
<div class="line"><a id="l01481" name="l01481"></a><span class="lineno"> 1481</span><span class="comment">//</span></div>
<div class="line"><a id="l01482" name="l01482"></a><span class="lineno"> 1482</span><span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01483" name="l01483"></a><span class="lineno"> 1483</span>GTEST_API_ AssertionResult CmpHelperSTRCASENE(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
<div class="line"><a id="l01484" name="l01484"></a><span class="lineno"> 1484</span>                                              <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
<div class="line"><a id="l01485" name="l01485"></a><span class="lineno"> 1485</span>                                              <span class="keyword">const</span> <span class="keywordtype">char</span>* s1, <span class="keyword">const</span> <span class="keywordtype">char</span>* s2);</div>
<div class="line"><a id="l01486" name="l01486"></a><span class="lineno"> 1486</span> </div>
<div class="line"><a id="l01487" name="l01487"></a><span class="lineno"> 1487</span><span class="comment">// Helper function for *_STREQ on wide strings.</span></div>
<div class="line"><a id="l01488" name="l01488"></a><span class="lineno"> 1488</span><span class="comment">//</span></div>
<div class="line"><a id="l01489" name="l01489"></a><span class="lineno"> 1489</span><span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01490" name="l01490"></a><span class="lineno"> 1490</span>GTEST_API_ AssertionResult CmpHelperSTREQ(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
<div class="line"><a id="l01491" name="l01491"></a><span class="lineno"> 1491</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
<div class="line"><a id="l01492" name="l01492"></a><span class="lineno"> 1492</span>                                          <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* s1, <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* s2);</div>
<div class="line"><a id="l01493" name="l01493"></a><span class="lineno"> 1493</span> </div>
<div class="line"><a id="l01494" name="l01494"></a><span class="lineno"> 1494</span><span class="comment">// Helper function for *_STRNE on wide strings.</span></div>
<div class="line"><a id="l01495" name="l01495"></a><span class="lineno"> 1495</span><span class="comment">//</span></div>
<div class="line"><a id="l01496" name="l01496"></a><span class="lineno"> 1496</span><span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01497" name="l01497"></a><span class="lineno"> 1497</span>GTEST_API_ AssertionResult CmpHelperSTRNE(<span class="keyword">const</span> <span class="keywordtype">char</span>* s1_expression,</div>
<div class="line"><a id="l01498" name="l01498"></a><span class="lineno"> 1498</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* s2_expression,</div>
<div class="line"><a id="l01499" name="l01499"></a><span class="lineno"> 1499</span>                                          <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* s1, <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* s2);</div>
<div class="line"><a id="l01500" name="l01500"></a><span class="lineno"> 1500</span> </div>
<div class="line"><a id="l01501" name="l01501"></a><span class="lineno"> 1501</span>}  <span class="comment">// namespace internal</span></div>
<div class="line"><a id="l01502" name="l01502"></a><span class="lineno"> 1502</span> </div>
<div class="line"><a id="l01503" name="l01503"></a><span class="lineno"> 1503</span><span class="comment">// IsSubstring() and IsNotSubstring() are intended to be used as the</span></div>
<div class="line"><a id="l01504" name="l01504"></a><span class="lineno"> 1504</span><span class="comment">// first argument to {EXPECT,ASSERT}_PRED_FORMAT2(), not by</span></div>
<div class="line"><a id="l01505" name="l01505"></a><span class="lineno"> 1505</span><span class="comment">// themselves.  They check whether needle is a substring of haystack</span></div>
<div class="line"><a id="l01506" name="l01506"></a><span class="lineno"> 1506</span><span class="comment">// (NULL is considered a substring of itself only), and return an</span></div>
<div class="line"><a id="l01507" name="l01507"></a><span class="lineno"> 1507</span><span class="comment">// appropriate error message when they fail.</span></div>
<div class="line"><a id="l01508" name="l01508"></a><span class="lineno"> 1508</span><span class="comment">//</span></div>
<div class="line"><a id="l01509" name="l01509"></a><span class="lineno"> 1509</span><span class="comment">// The {needle,haystack}_expr arguments are the stringified</span></div>
<div class="line"><a id="l01510" name="l01510"></a><span class="lineno"> 1510</span><span class="comment">// expressions that generated the two real arguments.</span></div>
<div class="line"><a id="l01511" name="l01511"></a><span class="lineno"> 1511</span>GTEST_API_ AssertionResult IsSubstring(<span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr,</div>
<div class="line"><a id="l01512" name="l01512"></a><span class="lineno"> 1512</span>                                       <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
<div class="line"><a id="l01513" name="l01513"></a><span class="lineno"> 1513</span>                                       <span class="keyword">const</span> <span class="keywordtype">char</span>* needle,</div>
<div class="line"><a id="l01514" name="l01514"></a><span class="lineno"> 1514</span>                                       <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack);</div>
<div class="line"><a id="l01515" name="l01515"></a><span class="lineno"> 1515</span>GTEST_API_ AssertionResult IsSubstring(<span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr,</div>
<div class="line"><a id="l01516" name="l01516"></a><span class="lineno"> 1516</span>                                       <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
<div class="line"><a id="l01517" name="l01517"></a><span class="lineno"> 1517</span>                                       <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* needle,</div>
<div class="line"><a id="l01518" name="l01518"></a><span class="lineno"> 1518</span>                                       <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* haystack);</div>
<div class="line"><a id="l01519" name="l01519"></a><span class="lineno"> 1519</span>GTEST_API_ AssertionResult IsNotSubstring(<span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr,</div>
<div class="line"><a id="l01520" name="l01520"></a><span class="lineno"> 1520</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
<div class="line"><a id="l01521" name="l01521"></a><span class="lineno"> 1521</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* needle,</div>
<div class="line"><a id="l01522" name="l01522"></a><span class="lineno"> 1522</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack);</div>
<div class="line"><a id="l01523" name="l01523"></a><span class="lineno"> 1523</span>GTEST_API_ AssertionResult IsNotSubstring(<span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr,</div>
<div class="line"><a id="l01524" name="l01524"></a><span class="lineno"> 1524</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
<div class="line"><a id="l01525" name="l01525"></a><span class="lineno"> 1525</span>                                          <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* needle,</div>
<div class="line"><a id="l01526" name="l01526"></a><span class="lineno"> 1526</span>                                          <span class="keyword">const</span> <span class="keywordtype">wchar_t</span>* haystack);</div>
<div class="line"><a id="l01527" name="l01527"></a><span class="lineno"> 1527</span>GTEST_API_ AssertionResult IsSubstring(<span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr,</div>
<div class="line"><a id="l01528" name="l01528"></a><span class="lineno"> 1528</span>                                       <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
<div class="line"><a id="l01529" name="l01529"></a><span class="lineno"> 1529</span>                                       const ::std::string&amp; needle,</div>
<div class="line"><a id="l01530" name="l01530"></a><span class="lineno"> 1530</span>                                       const ::std::string&amp; haystack);</div>
<div class="line"><a id="l01531" name="l01531"></a><span class="lineno"> 1531</span>GTEST_API_ AssertionResult IsNotSubstring(<span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr,</div>
<div class="line"><a id="l01532" name="l01532"></a><span class="lineno"> 1532</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
<div class="line"><a id="l01533" name="l01533"></a><span class="lineno"> 1533</span>                                          const ::std::string&amp; needle,</div>
<div class="line"><a id="l01534" name="l01534"></a><span class="lineno"> 1534</span>                                          const ::std::string&amp; haystack);</div>
<div class="line"><a id="l01535" name="l01535"></a><span class="lineno"> 1535</span> </div>
<div class="line"><a id="l01536" name="l01536"></a><span class="lineno"> 1536</span><span class="preprocessor">#if GTEST_HAS_STD_WSTRING</span></div>
<div class="line"><a id="l01537" name="l01537"></a><span class="lineno"> 1537</span>GTEST_API_ AssertionResult IsSubstring(<span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr,</div>
<div class="line"><a id="l01538" name="l01538"></a><span class="lineno"> 1538</span>                                       <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
<div class="line"><a id="l01539" name="l01539"></a><span class="lineno"> 1539</span>                                       const ::std::wstring&amp; needle,</div>
<div class="line"><a id="l01540" name="l01540"></a><span class="lineno"> 1540</span>                                       const ::std::wstring&amp; haystack);</div>
<div class="line"><a id="l01541" name="l01541"></a><span class="lineno"> 1541</span>GTEST_API_ AssertionResult IsNotSubstring(<span class="keyword">const</span> <span class="keywordtype">char</span>* needle_expr,</div>
<div class="line"><a id="l01542" name="l01542"></a><span class="lineno"> 1542</span>                                          <span class="keyword">const</span> <span class="keywordtype">char</span>* haystack_expr,</div>
<div class="line"><a id="l01543" name="l01543"></a><span class="lineno"> 1543</span>                                          const ::std::wstring&amp; needle,</div>
<div class="line"><a id="l01544" name="l01544"></a><span class="lineno"> 1544</span>                                          const ::std::wstring&amp; haystack);</div>
<div class="line"><a id="l01545" name="l01545"></a><span class="lineno"> 1545</span><span class="preprocessor">#endif  </span><span class="comment">// GTEST_HAS_STD_WSTRING</span></div>
<div class="line"><a id="l01546" name="l01546"></a><span class="lineno"> 1546</span> </div>
<div class="line"><a id="l01547" name="l01547"></a><span class="lineno"> 1547</span><span class="keyword">namespace </span>internal {</div>
<div class="line"><a id="l01548" name="l01548"></a><span class="lineno"> 1548</span> </div>
<div class="line"><a id="l01549" name="l01549"></a><span class="lineno"> 1549</span><span class="comment">// Helper template function for comparing floating-points.</span></div>
<div class="line"><a id="l01550" name="l01550"></a><span class="lineno"> 1550</span><span class="comment">//</span></div>
<div class="line"><a id="l01551" name="l01551"></a><span class="lineno"> 1551</span><span class="comment">// Template parameter:</span></div>
<div class="line"><a id="l01552" name="l01552"></a><span class="lineno"> 1552</span><span class="comment">//</span></div>
<div class="line"><a id="l01553" name="l01553"></a><span class="lineno"> 1553</span><span class="comment">//   RawType: the raw floating-point type (either float or double)</span></div>
<div class="line"><a id="l01554" name="l01554"></a><span class="lineno"> 1554</span><span class="comment">//</span></div>
<div class="line"><a id="l01555" name="l01555"></a><span class="lineno"> 1555</span><span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01556" name="l01556"></a><span class="lineno"> 1556</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> RawType&gt;</div>
<div class="line"><a id="l01557" name="l01557"></a><span class="lineno"> 1557</span>AssertionResult CmpHelperFloatingPointEQ(<span class="keyword">const</span> <span class="keywordtype">char</span>* lhs_expression,</div>
<div class="line"><a id="l01558" name="l01558"></a><span class="lineno"> 1558</span>                                         <span class="keyword">const</span> <span class="keywordtype">char</span>* rhs_expression,</div>
<div class="line"><a id="l01559" name="l01559"></a><span class="lineno"> 1559</span>                                         RawType lhs_value, RawType rhs_value) {</div>
<div class="line"><a id="l01560" name="l01560"></a><span class="lineno"> 1560</span>  <span class="keyword">const</span> <a class="code hl_class" href="class_floating_point.html">FloatingPoint&lt;RawType&gt;</a> lhs(lhs_value), rhs(rhs_value);</div>
<div class="line"><a id="l01561" name="l01561"></a><span class="lineno"> 1561</span> </div>
<div class="line"><a id="l01562" name="l01562"></a><span class="lineno"> 1562</span>  <span class="keywordflow">if</span> (lhs.AlmostEquals(rhs)) {</div>
<div class="line"><a id="l01563" name="l01563"></a><span class="lineno"> 1563</span>    <span class="keywordflow">return</span> AssertionSuccess();</div>
<div class="line"><a id="l01564" name="l01564"></a><span class="lineno"> 1564</span>  }</div>
<div class="line"><a id="l01565" name="l01565"></a><span class="lineno"> 1565</span> </div>
<div class="line"><a id="l01566" name="l01566"></a><span class="lineno"> 1566</span>  ::std::stringstream lhs_ss;</div>
<div class="line"><a id="l01567" name="l01567"></a><span class="lineno"> 1567</span>  lhs_ss &lt;&lt; std::setprecision(std::numeric_limits&lt;RawType&gt;::digits10 + 2)</div>
<div class="line"><a id="l01568" name="l01568"></a><span class="lineno"> 1568</span>         &lt;&lt; lhs_value;</div>
<div class="line"><a id="l01569" name="l01569"></a><span class="lineno"> 1569</span> </div>
<div class="line"><a id="l01570" name="l01570"></a><span class="lineno"> 1570</span>  ::std::stringstream rhs_ss;</div>
<div class="line"><a id="l01571" name="l01571"></a><span class="lineno"> 1571</span>  rhs_ss &lt;&lt; std::setprecision(std::numeric_limits&lt;RawType&gt;::digits10 + 2)</div>
<div class="line"><a id="l01572" name="l01572"></a><span class="lineno"> 1572</span>         &lt;&lt; rhs_value;</div>
<div class="line"><a id="l01573" name="l01573"></a><span class="lineno"> 1573</span> </div>
<div class="line"><a id="l01574" name="l01574"></a><span class="lineno"> 1574</span>  <span class="keywordflow">return</span> EqFailure(lhs_expression, rhs_expression,</div>
<div class="line"><a id="l01575" name="l01575"></a><span class="lineno"> 1575</span>                   StringStreamToString(&amp;lhs_ss), StringStreamToString(&amp;rhs_ss),</div>
<div class="line"><a id="l01576" name="l01576"></a><span class="lineno"> 1576</span>                   <span class="keyword">false</span>);</div>
<div class="line"><a id="l01577" name="l01577"></a><span class="lineno"> 1577</span>}</div>
<div class="line"><a id="l01578" name="l01578"></a><span class="lineno"> 1578</span> </div>
<div class="line"><a id="l01579" name="l01579"></a><span class="lineno"> 1579</span><span class="comment">// Helper function for implementing ASSERT_NEAR.</span></div>
<div class="line"><a id="l01580" name="l01580"></a><span class="lineno"> 1580</span><span class="comment">//</span></div>
<div class="line"><a id="l01581" name="l01581"></a><span class="lineno"> 1581</span><span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN A USER PROGRAM.</span></div>
<div class="line"><a id="l01582" name="l01582"></a><span class="lineno"> 1582</span>GTEST_API_ AssertionResult DoubleNearPredFormat(<span class="keyword">const</span> <span class="keywordtype">char</span>* expr1,</div>
<div class="line"><a id="l01583" name="l01583"></a><span class="lineno"> 1583</span>                                                <span class="keyword">const</span> <span class="keywordtype">char</span>* expr2,</div>
<div class="line"><a id="l01584" name="l01584"></a><span class="lineno"> 1584</span>                                                <span class="keyword">const</span> <span class="keywordtype">char</span>* abs_error_expr,</div>
<div class="line"><a id="l01585" name="l01585"></a><span class="lineno"> 1585</span>                                                <span class="keywordtype">double</span> val1, <span class="keywordtype">double</span> val2,</div>
<div class="line"><a id="l01586" name="l01586"></a><span class="lineno"> 1586</span>                                                <span class="keywordtype">double</span> abs_error);</div>
<div class="line"><a id="l01587" name="l01587"></a><span class="lineno"> 1587</span> </div>
<div class="line"><a id="l01588" name="l01588"></a><span class="lineno"> 1588</span><span class="comment">// INTERNAL IMPLEMENTATION - DO NOT USE IN USER CODE.</span></div>
<div class="line"><a id="l01589" name="l01589"></a><span class="lineno"> 1589</span><span class="comment">// A class that enables one to stream messages to assertion macros</span></div>
<div class="foldopen" id="foldopen01590" data-start="{" data-end="};">
<div class="line"><a id="l01590" name="l01590"></a><span class="lineno"><a class="line" href="classtesting_1_1internal_1_1_assert_helper.html"> 1590</a></span><span class="keyword">class </span>GTEST_API_ AssertHelper {</div>
<div class="line"><a id="l01591" name="l01591"></a><span class="lineno"> 1591</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01592" name="l01592"></a><span class="lineno"> 1592</span>  <span class="comment">// Constructor.</span></div>
<div class="line"><a id="l01593" name="l01593"></a><span class="lineno"> 1593</span>  AssertHelper(TestPartResult::Type type, <span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line,</div>
<div class="line"><a id="l01594" name="l01594"></a><span class="lineno"> 1594</span>               <span class="keyword">const</span> <span class="keywordtype">char</span>* message);</div>
<div class="line"><a id="l01595" name="l01595"></a><span class="lineno"> 1595</span>  ~AssertHelper();</div>
<div class="line"><a id="l01596" name="l01596"></a><span class="lineno"> 1596</span> </div>
<div class="line"><a id="l01597" name="l01597"></a><span class="lineno"> 1597</span>  <span class="comment">// Message assignment is a semantic trick to enable assertion</span></div>
<div class="line"><a id="l01598" name="l01598"></a><span class="lineno"> 1598</span>  <span class="comment">// streaming; see the GTEST_MESSAGE_ macro below.</span></div>
<div class="line"><a id="l01599" name="l01599"></a><span class="lineno"> 1599</span>  <span class="keywordtype">void</span> operator=(<span class="keyword">const</span> <a class="code hl_class" href="classtesting_1_1_message.html">Message</a>&amp; message) <span class="keyword">const</span>;</div>
<div class="line"><a id="l01600" name="l01600"></a><span class="lineno"> 1600</span> </div>
<div class="line"><a id="l01601" name="l01601"></a><span class="lineno"> 1601</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l01602" name="l01602"></a><span class="lineno"> 1602</span>  <span class="comment">// We put our data in a struct so that the size of the AssertHelper class can</span></div>
<div class="line"><a id="l01603" name="l01603"></a><span class="lineno"> 1603</span>  <span class="comment">// be as small as possible.  This is important because gcc is incapable of</span></div>
<div class="line"><a id="l01604" name="l01604"></a><span class="lineno"> 1604</span>  <span class="comment">// re-using stack space even for temporary variables, so every EXPECT_EQ</span></div>
<div class="line"><a id="l01605" name="l01605"></a><span class="lineno"> 1605</span>  <span class="comment">// reserves stack space for another AssertHelper.</span></div>
<div class="line"><a id="l01606" name="l01606"></a><span class="lineno"> 1606</span>  <span class="keyword">struct </span>AssertHelperData {</div>
<div class="line"><a id="l01607" name="l01607"></a><span class="lineno"> 1607</span>    AssertHelperData(TestPartResult::Type t, <span class="keyword">const</span> <span class="keywordtype">char</span>* srcfile, <span class="keywordtype">int</span> line_num,</div>
<div class="line"><a id="l01608" name="l01608"></a><span class="lineno"> 1608</span>                     <span class="keyword">const</span> <span class="keywordtype">char</span>* msg)</div>
<div class="line"><a id="l01609" name="l01609"></a><span class="lineno"> 1609</span>        : type(t), file(srcfile), line(line_num), message(msg) {}</div>
<div class="line"><a id="l01610" name="l01610"></a><span class="lineno"> 1610</span> </div>
<div class="line"><a id="l01611" name="l01611"></a><span class="lineno"> 1611</span>    TestPartResult::Type <span class="keyword">const</span> type;</div>
<div class="line"><a id="l01612" name="l01612"></a><span class="lineno"> 1612</span>    <span class="keyword">const</span> <span class="keywordtype">char</span>* <span class="keyword">const</span> file;</div>
<div class="line"><a id="l01613" name="l01613"></a><span class="lineno"> 1613</span>    <span class="keywordtype">int</span> <span class="keyword">const</span> line;</div>
<div class="line"><a id="l01614" name="l01614"></a><span class="lineno"> 1614</span>    std::string <span class="keyword">const</span> message;</div>
<div class="line"><a id="l01615" name="l01615"></a><span class="lineno"> 1615</span> </div>
<div class="line"><a id="l01616" name="l01616"></a><span class="lineno"> 1616</span>   <span class="keyword">private</span>:</div>
<div class="line"><a id="l01617" name="l01617"></a><span class="lineno"> 1617</span>    AssertHelperData(<span class="keyword">const</span> AssertHelperData&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01618" name="l01618"></a><span class="lineno"> 1618</span>    AssertHelperData&amp; operator=(<span class="keyword">const</span> AssertHelperData&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01619" name="l01619"></a><span class="lineno"> 1619</span>  };</div>
<div class="line"><a id="l01620" name="l01620"></a><span class="lineno"> 1620</span> </div>
<div class="line"><a id="l01621" name="l01621"></a><span class="lineno"> 1621</span>  AssertHelperData* <span class="keyword">const</span> data_;</div>
<div class="line"><a id="l01622" name="l01622"></a><span class="lineno"> 1622</span> </div>
<div class="line"><a id="l01623" name="l01623"></a><span class="lineno"> 1623</span>  AssertHelper(<span class="keyword">const</span> AssertHelper&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01624" name="l01624"></a><span class="lineno"> 1624</span>  AssertHelper&amp; operator=(<span class="keyword">const</span> AssertHelper&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01625" name="l01625"></a><span class="lineno"> 1625</span>};</div>
</div>
<div class="line"><a id="l01626" name="l01626"></a><span class="lineno"> 1626</span> </div>
<div class="line"><a id="l01627" name="l01627"></a><span class="lineno"> 1627</span>}  <span class="comment">// namespace internal</span></div>
<div class="line"><a id="l01628" name="l01628"></a><span class="lineno"> 1628</span> </div>
<div class="line"><a id="l01629" name="l01629"></a><span class="lineno"> 1629</span><span class="comment">// The pure interface class that all value-parameterized tests inherit from.</span></div>
<div class="line"><a id="l01630" name="l01630"></a><span class="lineno"> 1630</span><span class="comment">// A value-parameterized class must inherit from both ::testing::Test and</span></div>
<div class="line"><a id="l01631" name="l01631"></a><span class="lineno"> 1631</span><span class="comment">// ::testing::WithParamInterface. In most cases that just means inheriting</span></div>
<div class="line"><a id="l01632" name="l01632"></a><span class="lineno"> 1632</span><span class="comment">// from ::testing::TestWithParam, but more complicated test hierarchies</span></div>
<div class="line"><a id="l01633" name="l01633"></a><span class="lineno"> 1633</span><span class="comment">// may need to inherit from Test and WithParamInterface at different levels.</span></div>
<div class="line"><a id="l01634" name="l01634"></a><span class="lineno"> 1634</span><span class="comment">//</span></div>
<div class="line"><a id="l01635" name="l01635"></a><span class="lineno"> 1635</span><span class="comment">// This interface has support for accessing the test parameter value via</span></div>
<div class="line"><a id="l01636" name="l01636"></a><span class="lineno"> 1636</span><span class="comment">// the GetParam() method.</span></div>
<div class="line"><a id="l01637" name="l01637"></a><span class="lineno"> 1637</span><span class="comment">//</span></div>
<div class="line"><a id="l01638" name="l01638"></a><span class="lineno"> 1638</span><span class="comment">// Use it with one of the parameter generator defining functions, like Range(),</span></div>
<div class="line"><a id="l01639" name="l01639"></a><span class="lineno"> 1639</span><span class="comment">// Values(), ValuesIn(), Bool(), Combine(), and ConvertGenerator&lt;T&gt;().</span></div>
<div class="line"><a id="l01640" name="l01640"></a><span class="lineno"> 1640</span><span class="comment">//</span></div>
<div class="line"><a id="l01641" name="l01641"></a><span class="lineno"> 1641</span><span class="comment">// class FooTest : public ::testing::TestWithParam&lt;int&gt; {</span></div>
<div class="line"><a id="l01642" name="l01642"></a><span class="lineno"> 1642</span><span class="comment">//  protected:</span></div>
<div class="line"><a id="l01643" name="l01643"></a><span class="lineno"> 1643</span><span class="comment">//   FooTest() {</span></div>
<div class="line"><a id="l01644" name="l01644"></a><span class="lineno"> 1644</span><span class="comment">//     // Can use GetParam() here.</span></div>
<div class="line"><a id="l01645" name="l01645"></a><span class="lineno"> 1645</span><span class="comment">//   }</span></div>
<div class="line"><a id="l01646" name="l01646"></a><span class="lineno"> 1646</span><span class="comment">//   ~FooTest() override {</span></div>
<div class="line"><a id="l01647" name="l01647"></a><span class="lineno"> 1647</span><span class="comment">//     // Can use GetParam() here.</span></div>
<div class="line"><a id="l01648" name="l01648"></a><span class="lineno"> 1648</span><span class="comment">//   }</span></div>
<div class="line"><a id="l01649" name="l01649"></a><span class="lineno"> 1649</span><span class="comment">//   void SetUp() override {</span></div>
<div class="line"><a id="l01650" name="l01650"></a><span class="lineno"> 1650</span><span class="comment">//     // Can use GetParam() here.</span></div>
<div class="line"><a id="l01651" name="l01651"></a><span class="lineno"> 1651</span><span class="comment">//   }</span></div>
<div class="line"><a id="l01652" name="l01652"></a><span class="lineno"> 1652</span><span class="comment">//   void TearDown override {</span></div>
<div class="line"><a id="l01653" name="l01653"></a><span class="lineno"> 1653</span><span class="comment">//     // Can use GetParam() here.</span></div>
<div class="line"><a id="l01654" name="l01654"></a><span class="lineno"> 1654</span><span class="comment">//   }</span></div>
<div class="line"><a id="l01655" name="l01655"></a><span class="lineno"> 1655</span><span class="comment">// };</span></div>
<div class="line"><a id="l01656" name="l01656"></a><span class="lineno"> 1656</span><span class="comment">// TEST_P(FooTest, DoesBar) {</span></div>
<div class="line"><a id="l01657" name="l01657"></a><span class="lineno"> 1657</span><span class="comment">//   // Can use GetParam() method here.</span></div>
<div class="line"><a id="l01658" name="l01658"></a><span class="lineno"> 1658</span><span class="comment">//   Foo foo;</span></div>
<div class="line"><a id="l01659" name="l01659"></a><span class="lineno"> 1659</span><span class="comment">//   ASSERT_TRUE(foo.DoesBar(GetParam()));</span></div>
<div class="line"><a id="l01660" name="l01660"></a><span class="lineno"> 1660</span><span class="comment">// }</span></div>
<div class="line"><a id="l01661" name="l01661"></a><span class="lineno"> 1661</span><span class="comment">// INSTANTIATE_TEST_SUITE_P(OneToTenRange, FooTest, ::testing::Range(1, 10));</span></div>
<div class="line"><a id="l01662" name="l01662"></a><span class="lineno"> 1662</span> </div>
<div class="line"><a id="l01663" name="l01663"></a><span class="lineno"> 1663</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt;</div>
<div class="foldopen" id="foldopen01664" data-start="{" data-end="};">
<div class="line"><a id="l01664" name="l01664"></a><span class="lineno"><a class="line" href="classtesting_1_1_with_param_interface.html"> 1664</a></span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1_with_param_interface.html">WithParamInterface</a> {</div>
<div class="line"><a id="l01665" name="l01665"></a><span class="lineno"> 1665</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01666" name="l01666"></a><span class="lineno"> 1666</span>  <span class="keyword">typedef</span> T ParamType;</div>
<div class="line"><a id="l01667" name="l01667"></a><span class="lineno"> 1667</span>  <span class="keyword">virtual</span> <a class="code hl_class" href="classtesting_1_1_with_param_interface.html">~WithParamInterface</a>() {}</div>
<div class="line"><a id="l01668" name="l01668"></a><span class="lineno"> 1668</span> </div>
<div class="line"><a id="l01669" name="l01669"></a><span class="lineno"> 1669</span>  <span class="comment">// The current parameter value. Is also available in the test fixture&#39;s</span></div>
<div class="line"><a id="l01670" name="l01670"></a><span class="lineno"> 1670</span>  <span class="comment">// constructor.</span></div>
<div class="line"><a id="l01671" name="l01671"></a><span class="lineno"> 1671</span>  <span class="keyword">static</span> <span class="keyword">const</span> ParamType&amp; GetParam() {</div>
<div class="line"><a id="l01672" name="l01672"></a><span class="lineno"> 1672</span>    GTEST_CHECK_(parameter_ != <span class="keyword">nullptr</span>)</div>
<div class="line"><a id="l01673" name="l01673"></a><span class="lineno"> 1673</span>        &lt;&lt; <span class="stringliteral">&quot;GetParam() can only be called inside a value-parameterized test &quot;</span></div>
<div class="line"><a id="l01674" name="l01674"></a><span class="lineno"> 1674</span>        &lt;&lt; <span class="stringliteral">&quot;-- did you intend to write TEST_P instead of TEST_F?&quot;</span>;</div>
<div class="line"><a id="l01675" name="l01675"></a><span class="lineno"> 1675</span>    <span class="keywordflow">return</span> *parameter_;</div>
<div class="line"><a id="l01676" name="l01676"></a><span class="lineno"> 1676</span>  }</div>
<div class="line"><a id="l01677" name="l01677"></a><span class="lineno"> 1677</span> </div>
<div class="line"><a id="l01678" name="l01678"></a><span class="lineno"> 1678</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l01679" name="l01679"></a><span class="lineno"> 1679</span>  <span class="comment">// Sets parameter value. The caller is responsible for making sure the value</span></div>
<div class="line"><a id="l01680" name="l01680"></a><span class="lineno"> 1680</span>  <span class="comment">// remains alive and unchanged throughout the current test.</span></div>
<div class="line"><a id="l01681" name="l01681"></a><span class="lineno"> 1681</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> SetParam(<span class="keyword">const</span> ParamType* parameter) { parameter_ = parameter; }</div>
<div class="line"><a id="l01682" name="l01682"></a><span class="lineno"> 1682</span> </div>
<div class="line"><a id="l01683" name="l01683"></a><span class="lineno"> 1683</span>  <span class="comment">// Static value used for accessing parameter during a test lifetime.</span></div>
<div class="line"><a id="l01684" name="l01684"></a><span class="lineno"> 1684</span>  <span class="keyword">static</span> <span class="keyword">const</span> ParamType* parameter_;</div>
<div class="line"><a id="l01685" name="l01685"></a><span class="lineno"> 1685</span> </div>
<div class="line"><a id="l01686" name="l01686"></a><span class="lineno"> 1686</span>  <span class="comment">// TestClass must be a subclass of WithParamInterface&lt;T&gt; and Test.</span></div>
<div class="line"><a id="l01687" name="l01687"></a><span class="lineno"> 1687</span>  <span class="keyword">template</span> &lt;<span class="keyword">class</span> TestClass&gt;</div>
<div class="line"><a id="l01688" name="l01688"></a><span class="lineno"> 1688</span>  <span class="keyword">friend</span> <span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1internal_1_1_parameterized_test_factory.html">internal::ParameterizedTestFactory</a>;</div>
<div class="line"><a id="l01689" name="l01689"></a><span class="lineno"> 1689</span>};</div>
</div>
<div class="line"><a id="l01690" name="l01690"></a><span class="lineno"> 1690</span> </div>
<div class="line"><a id="l01691" name="l01691"></a><span class="lineno"> 1691</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt;</div>
<div class="line"><a id="l01692" name="l01692"></a><span class="lineno"> 1692</span><span class="keyword">const</span> T* WithParamInterface&lt;T&gt;::parameter_ = <span class="keyword">nullptr</span>;</div>
<div class="line"><a id="l01693" name="l01693"></a><span class="lineno"> 1693</span> </div>
<div class="line"><a id="l01694" name="l01694"></a><span class="lineno"> 1694</span><span class="comment">// Most value-parameterized classes can ignore the existence of</span></div>
<div class="line"><a id="l01695" name="l01695"></a><span class="lineno"> 1695</span><span class="comment">// WithParamInterface, and can just inherit from ::testing::TestWithParam.</span></div>
<div class="line"><a id="l01696" name="l01696"></a><span class="lineno"> 1696</span> </div>
<div class="line"><a id="l01697" name="l01697"></a><span class="lineno"> 1697</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt;</div>
<div class="line"><a id="l01698" name="l01698"></a><span class="lineno"><a class="line" href="classtesting_1_1_test_with_param.html"> 1698</a></span><span class="keyword">class </span><a class="code hl_class" href="classtesting_1_1_test_with_param.html">TestWithParam</a> : <span class="keyword">public</span> Test, <span class="keyword">public</span> <a class="code hl_class" href="classtesting_1_1_with_param_interface.html">WithParamInterface</a>&lt;T&gt; {};</div>
<div class="line"><a id="l01699" name="l01699"></a><span class="lineno"> 1699</span> </div>
<div class="line"><a id="l01700" name="l01700"></a><span class="lineno"> 1700</span><span class="comment">// Macros for indicating success/failure in test code.</span></div>
<div class="line"><a id="l01701" name="l01701"></a><span class="lineno"> 1701</span> </div>
<div class="line"><a id="l01702" name="l01702"></a><span class="lineno"> 1702</span><span class="comment">// Skips test in runtime.</span></div>
<div class="line"><a id="l01703" name="l01703"></a><span class="lineno"> 1703</span><span class="comment">// Skipping test aborts current function.</span></div>
<div class="line"><a id="l01704" name="l01704"></a><span class="lineno"> 1704</span><span class="comment">// Skipped tests are neither successful nor failed.</span></div>
<div class="line"><a id="l01705" name="l01705"></a><span class="lineno"> 1705</span><span class="preprocessor">#define GTEST_SKIP() GTEST_SKIP_(&quot;&quot;)</span></div>
<div class="line"><a id="l01706" name="l01706"></a><span class="lineno"> 1706</span> </div>
<div class="line"><a id="l01707" name="l01707"></a><span class="lineno"> 1707</span><span class="comment">// ADD_FAILURE unconditionally adds a failure to the current test.</span></div>
<div class="line"><a id="l01708" name="l01708"></a><span class="lineno"> 1708</span><span class="comment">// SUCCEED generates a success - it doesn&#39;t automatically make the</span></div>
<div class="line"><a id="l01709" name="l01709"></a><span class="lineno"> 1709</span><span class="comment">// current test successful, as a test is only successful when it has</span></div>
<div class="line"><a id="l01710" name="l01710"></a><span class="lineno"> 1710</span><span class="comment">// no failure.</span></div>
<div class="line"><a id="l01711" name="l01711"></a><span class="lineno"> 1711</span><span class="comment">//</span></div>
<div class="line"><a id="l01712" name="l01712"></a><span class="lineno"> 1712</span><span class="comment">// EXPECT_* verifies that a certain condition is satisfied.  If not,</span></div>
<div class="line"><a id="l01713" name="l01713"></a><span class="lineno"> 1713</span><span class="comment">// it behaves like ADD_FAILURE.  In particular:</span></div>
<div class="line"><a id="l01714" name="l01714"></a><span class="lineno"> 1714</span><span class="comment">//</span></div>
<div class="line"><a id="l01715" name="l01715"></a><span class="lineno"> 1715</span><span class="comment">//   EXPECT_TRUE  verifies that a Boolean condition is true.</span></div>
<div class="line"><a id="l01716" name="l01716"></a><span class="lineno"> 1716</span><span class="comment">//   EXPECT_FALSE verifies that a Boolean condition is false.</span></div>
<div class="line"><a id="l01717" name="l01717"></a><span class="lineno"> 1717</span><span class="comment">//</span></div>
<div class="line"><a id="l01718" name="l01718"></a><span class="lineno"> 1718</span><span class="comment">// FAIL and ASSERT_* are similar to ADD_FAILURE and EXPECT_*, except</span></div>
<div class="line"><a id="l01719" name="l01719"></a><span class="lineno"> 1719</span><span class="comment">// that they will also abort the current function on failure.  People</span></div>
<div class="line"><a id="l01720" name="l01720"></a><span class="lineno"> 1720</span><span class="comment">// usually want the fail-fast behavior of FAIL and ASSERT_*, but those</span></div>
<div class="line"><a id="l01721" name="l01721"></a><span class="lineno"> 1721</span><span class="comment">// writing data-driven tests often find themselves using ADD_FAILURE</span></div>
<div class="line"><a id="l01722" name="l01722"></a><span class="lineno"> 1722</span><span class="comment">// and EXPECT_* more.</span></div>
<div class="line"><a id="l01723" name="l01723"></a><span class="lineno"> 1723</span> </div>
<div class="line"><a id="l01724" name="l01724"></a><span class="lineno"> 1724</span><span class="comment">// Generates a nonfatal failure with a generic message.</span></div>
<div class="line"><a id="l01725" name="l01725"></a><span class="lineno"> 1725</span><span class="preprocessor">#define ADD_FAILURE() GTEST_NONFATAL_FAILURE_(&quot;Failed&quot;)</span></div>
<div class="line"><a id="l01726" name="l01726"></a><span class="lineno"> 1726</span> </div>
<div class="line"><a id="l01727" name="l01727"></a><span class="lineno"> 1727</span><span class="comment">// Generates a nonfatal failure at the given source file location with</span></div>
<div class="line"><a id="l01728" name="l01728"></a><span class="lineno"> 1728</span><span class="comment">// a generic message.</span></div>
<div class="line"><a id="l01729" name="l01729"></a><span class="lineno"> 1729</span><span class="preprocessor">#define ADD_FAILURE_AT(file, line)        \</span></div>
<div class="line"><a id="l01730" name="l01730"></a><span class="lineno"> 1730</span><span class="preprocessor">  GTEST_MESSAGE_AT_(file, line, &quot;Failed&quot;, \</span></div>
<div class="line"><a id="l01731" name="l01731"></a><span class="lineno"> 1731</span><span class="preprocessor">                    ::testing::TestPartResult::kNonFatalFailure)</span></div>
<div class="line"><a id="l01732" name="l01732"></a><span class="lineno"> 1732</span> </div>
<div class="line"><a id="l01733" name="l01733"></a><span class="lineno"> 1733</span><span class="comment">// Generates a fatal failure with a generic message.</span></div>
<div class="line"><a id="l01734" name="l01734"></a><span class="lineno"> 1734</span><span class="preprocessor">#define GTEST_FAIL() GTEST_FATAL_FAILURE_(&quot;Failed&quot;)</span></div>
<div class="line"><a id="l01735" name="l01735"></a><span class="lineno"> 1735</span> </div>
<div class="line"><a id="l01736" name="l01736"></a><span class="lineno"> 1736</span><span class="comment">// Like GTEST_FAIL(), but at the given source file location.</span></div>
<div class="line"><a id="l01737" name="l01737"></a><span class="lineno"> 1737</span><span class="preprocessor">#define GTEST_FAIL_AT(file, line)         \</span></div>
<div class="line"><a id="l01738" name="l01738"></a><span class="lineno"> 1738</span><span class="preprocessor">  GTEST_MESSAGE_AT_(file, line, &quot;Failed&quot;, \</span></div>
<div class="line"><a id="l01739" name="l01739"></a><span class="lineno"> 1739</span><span class="preprocessor">                    ::testing::TestPartResult::kFatalFailure)</span></div>
<div class="line"><a id="l01740" name="l01740"></a><span class="lineno"> 1740</span> </div>
<div class="line"><a id="l01741" name="l01741"></a><span class="lineno"> 1741</span><span class="comment">// Define this macro to 1 to omit the definition of FAIL(), which is a</span></div>
<div class="line"><a id="l01742" name="l01742"></a><span class="lineno"> 1742</span><span class="comment">// generic name and clashes with some other libraries.</span></div>
<div class="line"><a id="l01743" name="l01743"></a><span class="lineno"> 1743</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_FAIL</span></div>
<div class="line"><a id="l01744" name="l01744"></a><span class="lineno"> 1744</span><span class="preprocessor">#define FAIL() GTEST_FAIL()</span></div>
<div class="line"><a id="l01745" name="l01745"></a><span class="lineno"> 1745</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01746" name="l01746"></a><span class="lineno"> 1746</span> </div>
<div class="line"><a id="l01747" name="l01747"></a><span class="lineno"> 1747</span><span class="comment">// Generates a success with a generic message.</span></div>
<div class="line"><a id="l01748" name="l01748"></a><span class="lineno"> 1748</span><span class="preprocessor">#define GTEST_SUCCEED() GTEST_SUCCESS_(&quot;Succeeded&quot;)</span></div>
<div class="line"><a id="l01749" name="l01749"></a><span class="lineno"> 1749</span> </div>
<div class="line"><a id="l01750" name="l01750"></a><span class="lineno"> 1750</span><span class="comment">// Define this macro to 1 to omit the definition of SUCCEED(), which</span></div>
<div class="line"><a id="l01751" name="l01751"></a><span class="lineno"> 1751</span><span class="comment">// is a generic name and clashes with some other libraries.</span></div>
<div class="line"><a id="l01752" name="l01752"></a><span class="lineno"> 1752</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_SUCCEED</span></div>
<div class="line"><a id="l01753" name="l01753"></a><span class="lineno"> 1753</span><span class="preprocessor">#define SUCCEED() GTEST_SUCCEED()</span></div>
<div class="line"><a id="l01754" name="l01754"></a><span class="lineno"> 1754</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01755" name="l01755"></a><span class="lineno"> 1755</span> </div>
<div class="line"><a id="l01756" name="l01756"></a><span class="lineno"> 1756</span><span class="comment">// Macros for testing exceptions.</span></div>
<div class="line"><a id="l01757" name="l01757"></a><span class="lineno"> 1757</span><span class="comment">//</span></div>
<div class="line"><a id="l01758" name="l01758"></a><span class="lineno"> 1758</span><span class="comment">//    * {ASSERT|EXPECT}_THROW(statement, expected_exception):</span></div>
<div class="line"><a id="l01759" name="l01759"></a><span class="lineno"> 1759</span><span class="comment">//         Tests that the statement throws the expected exception.</span></div>
<div class="line"><a id="l01760" name="l01760"></a><span class="lineno"> 1760</span><span class="comment">//    * {ASSERT|EXPECT}_NO_THROW(statement):</span></div>
<div class="line"><a id="l01761" name="l01761"></a><span class="lineno"> 1761</span><span class="comment">//         Tests that the statement doesn&#39;t throw any exception.</span></div>
<div class="line"><a id="l01762" name="l01762"></a><span class="lineno"> 1762</span><span class="comment">//    * {ASSERT|EXPECT}_ANY_THROW(statement):</span></div>
<div class="line"><a id="l01763" name="l01763"></a><span class="lineno"> 1763</span><span class="comment">//         Tests that the statement throws an exception.</span></div>
<div class="line"><a id="l01764" name="l01764"></a><span class="lineno"> 1764</span> </div>
<div class="line"><a id="l01765" name="l01765"></a><span class="lineno"> 1765</span><span class="preprocessor">#define EXPECT_THROW(statement, expected_exception) \</span></div>
<div class="line"><a id="l01766" name="l01766"></a><span class="lineno"> 1766</span><span class="preprocessor">  GTEST_TEST_THROW_(statement, expected_exception, GTEST_NONFATAL_FAILURE_)</span></div>
<div class="line"><a id="l01767" name="l01767"></a><span class="lineno"> 1767</span><span class="preprocessor">#define EXPECT_NO_THROW(statement) \</span></div>
<div class="line"><a id="l01768" name="l01768"></a><span class="lineno"> 1768</span><span class="preprocessor">  GTEST_TEST_NO_THROW_(statement, GTEST_NONFATAL_FAILURE_)</span></div>
<div class="line"><a id="l01769" name="l01769"></a><span class="lineno"> 1769</span><span class="preprocessor">#define EXPECT_ANY_THROW(statement) \</span></div>
<div class="line"><a id="l01770" name="l01770"></a><span class="lineno"> 1770</span><span class="preprocessor">  GTEST_TEST_ANY_THROW_(statement, GTEST_NONFATAL_FAILURE_)</span></div>
<div class="line"><a id="l01771" name="l01771"></a><span class="lineno"> 1771</span><span class="preprocessor">#define ASSERT_THROW(statement, expected_exception) \</span></div>
<div class="line"><a id="l01772" name="l01772"></a><span class="lineno"> 1772</span><span class="preprocessor">  GTEST_TEST_THROW_(statement, expected_exception, GTEST_FATAL_FAILURE_)</span></div>
<div class="line"><a id="l01773" name="l01773"></a><span class="lineno"> 1773</span><span class="preprocessor">#define ASSERT_NO_THROW(statement) \</span></div>
<div class="line"><a id="l01774" name="l01774"></a><span class="lineno"> 1774</span><span class="preprocessor">  GTEST_TEST_NO_THROW_(statement, GTEST_FATAL_FAILURE_)</span></div>
<div class="line"><a id="l01775" name="l01775"></a><span class="lineno"> 1775</span><span class="preprocessor">#define ASSERT_ANY_THROW(statement) \</span></div>
<div class="line"><a id="l01776" name="l01776"></a><span class="lineno"> 1776</span><span class="preprocessor">  GTEST_TEST_ANY_THROW_(statement, GTEST_FATAL_FAILURE_)</span></div>
<div class="line"><a id="l01777" name="l01777"></a><span class="lineno"> 1777</span> </div>
<div class="line"><a id="l01778" name="l01778"></a><span class="lineno"> 1778</span><span class="comment">// Boolean assertions. Condition can be either a Boolean expression or an</span></div>
<div class="line"><a id="l01779" name="l01779"></a><span class="lineno"> 1779</span><span class="comment">// AssertionResult. For more information on how to use AssertionResult with</span></div>
<div class="line"><a id="l01780" name="l01780"></a><span class="lineno"> 1780</span><span class="comment">// these macros see comments on that class.</span></div>
<div class="line"><a id="l01781" name="l01781"></a><span class="lineno"> 1781</span><span class="preprocessor">#define GTEST_EXPECT_TRUE(condition)                      \</span></div>
<div class="line"><a id="l01782" name="l01782"></a><span class="lineno"> 1782</span><span class="preprocessor">  GTEST_TEST_BOOLEAN_(condition, #condition, false, true, \</span></div>
<div class="line"><a id="l01783" name="l01783"></a><span class="lineno"> 1783</span><span class="preprocessor">                      GTEST_NONFATAL_FAILURE_)</span></div>
<div class="line"><a id="l01784" name="l01784"></a><span class="lineno"> 1784</span><span class="preprocessor">#define GTEST_EXPECT_FALSE(condition)                        \</span></div>
<div class="line"><a id="l01785" name="l01785"></a><span class="lineno"> 1785</span><span class="preprocessor">  GTEST_TEST_BOOLEAN_(!(condition), #condition, true, false, \</span></div>
<div class="line"><a id="l01786" name="l01786"></a><span class="lineno"> 1786</span><span class="preprocessor">                      GTEST_NONFATAL_FAILURE_)</span></div>
<div class="line"><a id="l01787" name="l01787"></a><span class="lineno"> 1787</span><span class="preprocessor">#define GTEST_ASSERT_TRUE(condition) \</span></div>
<div class="line"><a id="l01788" name="l01788"></a><span class="lineno"> 1788</span><span class="preprocessor">  GTEST_TEST_BOOLEAN_(condition, #condition, false, true, GTEST_FATAL_FAILURE_)</span></div>
<div class="line"><a id="l01789" name="l01789"></a><span class="lineno"> 1789</span><span class="preprocessor">#define GTEST_ASSERT_FALSE(condition)                        \</span></div>
<div class="line"><a id="l01790" name="l01790"></a><span class="lineno"> 1790</span><span class="preprocessor">  GTEST_TEST_BOOLEAN_(!(condition), #condition, true, false, \</span></div>
<div class="line"><a id="l01791" name="l01791"></a><span class="lineno"> 1791</span><span class="preprocessor">                      GTEST_FATAL_FAILURE_)</span></div>
<div class="line"><a id="l01792" name="l01792"></a><span class="lineno"> 1792</span> </div>
<div class="line"><a id="l01793" name="l01793"></a><span class="lineno"> 1793</span><span class="comment">// Define these macros to 1 to omit the definition of the corresponding</span></div>
<div class="line"><a id="l01794" name="l01794"></a><span class="lineno"> 1794</span><span class="comment">// EXPECT or ASSERT, which clashes with some users&#39; own code.</span></div>
<div class="line"><a id="l01795" name="l01795"></a><span class="lineno"> 1795</span> </div>
<div class="line"><a id="l01796" name="l01796"></a><span class="lineno"> 1796</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_EXPECT_TRUE</span></div>
<div class="line"><a id="l01797" name="l01797"></a><span class="lineno"> 1797</span><span class="preprocessor">#define EXPECT_TRUE(condition) GTEST_EXPECT_TRUE(condition)</span></div>
<div class="line"><a id="l01798" name="l01798"></a><span class="lineno"> 1798</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01799" name="l01799"></a><span class="lineno"> 1799</span> </div>
<div class="line"><a id="l01800" name="l01800"></a><span class="lineno"> 1800</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_EXPECT_FALSE</span></div>
<div class="line"><a id="l01801" name="l01801"></a><span class="lineno"> 1801</span><span class="preprocessor">#define EXPECT_FALSE(condition) GTEST_EXPECT_FALSE(condition)</span></div>
<div class="line"><a id="l01802" name="l01802"></a><span class="lineno"> 1802</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01803" name="l01803"></a><span class="lineno"> 1803</span> </div>
<div class="line"><a id="l01804" name="l01804"></a><span class="lineno"> 1804</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_TRUE</span></div>
<div class="line"><a id="l01805" name="l01805"></a><span class="lineno"> 1805</span><span class="preprocessor">#define ASSERT_TRUE(condition) GTEST_ASSERT_TRUE(condition)</span></div>
<div class="line"><a id="l01806" name="l01806"></a><span class="lineno"> 1806</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01807" name="l01807"></a><span class="lineno"> 1807</span> </div>
<div class="line"><a id="l01808" name="l01808"></a><span class="lineno"> 1808</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_FALSE</span></div>
<div class="line"><a id="l01809" name="l01809"></a><span class="lineno"> 1809</span><span class="preprocessor">#define ASSERT_FALSE(condition) GTEST_ASSERT_FALSE(condition)</span></div>
<div class="line"><a id="l01810" name="l01810"></a><span class="lineno"> 1810</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01811" name="l01811"></a><span class="lineno"> 1811</span> </div>
<div class="line"><a id="l01812" name="l01812"></a><span class="lineno"> 1812</span><span class="comment">// Macros for testing equalities and inequalities.</span></div>
<div class="line"><a id="l01813" name="l01813"></a><span class="lineno"> 1813</span><span class="comment">//</span></div>
<div class="line"><a id="l01814" name="l01814"></a><span class="lineno"> 1814</span><span class="comment">//    * {ASSERT|EXPECT}_EQ(v1, v2): Tests that v1 == v2</span></div>
<div class="line"><a id="l01815" name="l01815"></a><span class="lineno"> 1815</span><span class="comment">//    * {ASSERT|EXPECT}_NE(v1, v2): Tests that v1 != v2</span></div>
<div class="line"><a id="l01816" name="l01816"></a><span class="lineno"> 1816</span><span class="comment">//    * {ASSERT|EXPECT}_LT(v1, v2): Tests that v1 &lt; v2</span></div>
<div class="line"><a id="l01817" name="l01817"></a><span class="lineno"> 1817</span><span class="comment">//    * {ASSERT|EXPECT}_LE(v1, v2): Tests that v1 &lt;= v2</span></div>
<div class="line"><a id="l01818" name="l01818"></a><span class="lineno"> 1818</span><span class="comment">//    * {ASSERT|EXPECT}_GT(v1, v2): Tests that v1 &gt; v2</span></div>
<div class="line"><a id="l01819" name="l01819"></a><span class="lineno"> 1819</span><span class="comment">//    * {ASSERT|EXPECT}_GE(v1, v2): Tests that v1 &gt;= v2</span></div>
<div class="line"><a id="l01820" name="l01820"></a><span class="lineno"> 1820</span><span class="comment">//</span></div>
<div class="line"><a id="l01821" name="l01821"></a><span class="lineno"> 1821</span><span class="comment">// When they are not, Google Test prints both the tested expressions and</span></div>
<div class="line"><a id="l01822" name="l01822"></a><span class="lineno"> 1822</span><span class="comment">// their actual values.  The values must be compatible built-in types,</span></div>
<div class="line"><a id="l01823" name="l01823"></a><span class="lineno"> 1823</span><span class="comment">// or you will get a compiler error.  By &quot;compatible&quot; we mean that the</span></div>
<div class="line"><a id="l01824" name="l01824"></a><span class="lineno"> 1824</span><span class="comment">// values can be compared by the respective operator.</span></div>
<div class="line"><a id="l01825" name="l01825"></a><span class="lineno"> 1825</span><span class="comment">//</span></div>
<div class="line"><a id="l01826" name="l01826"></a><span class="lineno"> 1826</span><span class="comment">// Note:</span></div>
<div class="line"><a id="l01827" name="l01827"></a><span class="lineno"> 1827</span><span class="comment">//</span></div>
<div class="line"><a id="l01828" name="l01828"></a><span class="lineno"> 1828</span><span class="comment">//   1. It is possible to make a user-defined type work with</span></div>
<div class="line"><a id="l01829" name="l01829"></a><span class="lineno"> 1829</span><span class="comment">//   {ASSERT|EXPECT}_??(), but that requires overloading the</span></div>
<div class="line"><a id="l01830" name="l01830"></a><span class="lineno"> 1830</span><span class="comment">//   comparison operators and is thus discouraged by the Google C++</span></div>
<div class="line"><a id="l01831" name="l01831"></a><span class="lineno"> 1831</span><span class="comment">//   Usage Guide.  Therefore, you are advised to use the</span></div>
<div class="line"><a id="l01832" name="l01832"></a><span class="lineno"> 1832</span><span class="comment">//   {ASSERT|EXPECT}_TRUE() macro to assert that two objects are</span></div>
<div class="line"><a id="l01833" name="l01833"></a><span class="lineno"> 1833</span><span class="comment">//   equal.</span></div>
<div class="line"><a id="l01834" name="l01834"></a><span class="lineno"> 1834</span><span class="comment">//</span></div>
<div class="line"><a id="l01835" name="l01835"></a><span class="lineno"> 1835</span><span class="comment">//   2. The {ASSERT|EXPECT}_??() macros do pointer comparisons on</span></div>
<div class="line"><a id="l01836" name="l01836"></a><span class="lineno"> 1836</span><span class="comment">//   pointers (in particular, C strings).  Therefore, if you use it</span></div>
<div class="line"><a id="l01837" name="l01837"></a><span class="lineno"> 1837</span><span class="comment">//   with two C strings, you are testing how their locations in memory</span></div>
<div class="line"><a id="l01838" name="l01838"></a><span class="lineno"> 1838</span><span class="comment">//   are related, not how their content is related.  To compare two C</span></div>
<div class="line"><a id="l01839" name="l01839"></a><span class="lineno"> 1839</span><span class="comment">//   strings by content, use {ASSERT|EXPECT}_STR*().</span></div>
<div class="line"><a id="l01840" name="l01840"></a><span class="lineno"> 1840</span><span class="comment">//</span></div>
<div class="line"><a id="l01841" name="l01841"></a><span class="lineno"> 1841</span><span class="comment">//   3. {ASSERT|EXPECT}_EQ(v1, v2) is preferred to</span></div>
<div class="line"><a id="l01842" name="l01842"></a><span class="lineno"> 1842</span><span class="comment">//   {ASSERT|EXPECT}_TRUE(v1 == v2), as the former tells you</span></div>
<div class="line"><a id="l01843" name="l01843"></a><span class="lineno"> 1843</span><span class="comment">//   what the actual value is when it fails, and similarly for the</span></div>
<div class="line"><a id="l01844" name="l01844"></a><span class="lineno"> 1844</span><span class="comment">//   other comparisons.</span></div>
<div class="line"><a id="l01845" name="l01845"></a><span class="lineno"> 1845</span><span class="comment">//</span></div>
<div class="line"><a id="l01846" name="l01846"></a><span class="lineno"> 1846</span><span class="comment">//   4. Do not depend on the order in which {ASSERT|EXPECT}_??()</span></div>
<div class="line"><a id="l01847" name="l01847"></a><span class="lineno"> 1847</span><span class="comment">//   evaluate their arguments, which is undefined.</span></div>
<div class="line"><a id="l01848" name="l01848"></a><span class="lineno"> 1848</span><span class="comment">//</span></div>
<div class="line"><a id="l01849" name="l01849"></a><span class="lineno"> 1849</span><span class="comment">//   5. These macros evaluate their arguments exactly once.</span></div>
<div class="line"><a id="l01850" name="l01850"></a><span class="lineno"> 1850</span><span class="comment">//</span></div>
<div class="line"><a id="l01851" name="l01851"></a><span class="lineno"> 1851</span><span class="comment">// Examples:</span></div>
<div class="line"><a id="l01852" name="l01852"></a><span class="lineno"> 1852</span><span class="comment">//</span></div>
<div class="line"><a id="l01853" name="l01853"></a><span class="lineno"> 1853</span><span class="comment">//   EXPECT_NE(Foo(), 5);</span></div>
<div class="line"><a id="l01854" name="l01854"></a><span class="lineno"> 1854</span><span class="comment">//   EXPECT_EQ(a_pointer, NULL);</span></div>
<div class="line"><a id="l01855" name="l01855"></a><span class="lineno"> 1855</span><span class="comment">//   ASSERT_LT(i, array_size);</span></div>
<div class="line"><a id="l01856" name="l01856"></a><span class="lineno"> 1856</span><span class="comment">//   ASSERT_GT(records.size(), 0) &lt;&lt; &quot;There is no record left.&quot;;</span></div>
<div class="line"><a id="l01857" name="l01857"></a><span class="lineno"> 1857</span> </div>
<div class="line"><a id="l01858" name="l01858"></a><span class="lineno"> 1858</span><span class="preprocessor">#define EXPECT_EQ(val1, val2) \</span></div>
<div class="line"><a id="l01859" name="l01859"></a><span class="lineno"> 1859</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::EqHelper::Compare, val1, val2)</span></div>
<div class="line"><a id="l01860" name="l01860"></a><span class="lineno"> 1860</span><span class="preprocessor">#define EXPECT_NE(val1, val2) \</span></div>
<div class="line"><a id="l01861" name="l01861"></a><span class="lineno"> 1861</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)</span></div>
<div class="line"><a id="l01862" name="l01862"></a><span class="lineno"> 1862</span><span class="preprocessor">#define EXPECT_LE(val1, val2) \</span></div>
<div class="line"><a id="l01863" name="l01863"></a><span class="lineno"> 1863</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)</span></div>
<div class="line"><a id="l01864" name="l01864"></a><span class="lineno"> 1864</span><span class="preprocessor">#define EXPECT_LT(val1, val2) \</span></div>
<div class="line"><a id="l01865" name="l01865"></a><span class="lineno"> 1865</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)</span></div>
<div class="line"><a id="l01866" name="l01866"></a><span class="lineno"> 1866</span><span class="preprocessor">#define EXPECT_GE(val1, val2) \</span></div>
<div class="line"><a id="l01867" name="l01867"></a><span class="lineno"> 1867</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)</span></div>
<div class="line"><a id="l01868" name="l01868"></a><span class="lineno"> 1868</span><span class="preprocessor">#define EXPECT_GT(val1, val2) \</span></div>
<div class="line"><a id="l01869" name="l01869"></a><span class="lineno"> 1869</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)</span></div>
<div class="line"><a id="l01870" name="l01870"></a><span class="lineno"> 1870</span> </div>
<div class="line"><a id="l01871" name="l01871"></a><span class="lineno"> 1871</span><span class="preprocessor">#define GTEST_ASSERT_EQ(val1, val2) \</span></div>
<div class="line"><a id="l01872" name="l01872"></a><span class="lineno"> 1872</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::EqHelper::Compare, val1, val2)</span></div>
<div class="line"><a id="l01873" name="l01873"></a><span class="lineno"> 1873</span><span class="preprocessor">#define GTEST_ASSERT_NE(val1, val2) \</span></div>
<div class="line"><a id="l01874" name="l01874"></a><span class="lineno"> 1874</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperNE, val1, val2)</span></div>
<div class="line"><a id="l01875" name="l01875"></a><span class="lineno"> 1875</span><span class="preprocessor">#define GTEST_ASSERT_LE(val1, val2) \</span></div>
<div class="line"><a id="l01876" name="l01876"></a><span class="lineno"> 1876</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLE, val1, val2)</span></div>
<div class="line"><a id="l01877" name="l01877"></a><span class="lineno"> 1877</span><span class="preprocessor">#define GTEST_ASSERT_LT(val1, val2) \</span></div>
<div class="line"><a id="l01878" name="l01878"></a><span class="lineno"> 1878</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperLT, val1, val2)</span></div>
<div class="line"><a id="l01879" name="l01879"></a><span class="lineno"> 1879</span><span class="preprocessor">#define GTEST_ASSERT_GE(val1, val2) \</span></div>
<div class="line"><a id="l01880" name="l01880"></a><span class="lineno"> 1880</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGE, val1, val2)</span></div>
<div class="line"><a id="l01881" name="l01881"></a><span class="lineno"> 1881</span><span class="preprocessor">#define GTEST_ASSERT_GT(val1, val2) \</span></div>
<div class="line"><a id="l01882" name="l01882"></a><span class="lineno"> 1882</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperGT, val1, val2)</span></div>
<div class="line"><a id="l01883" name="l01883"></a><span class="lineno"> 1883</span> </div>
<div class="line"><a id="l01884" name="l01884"></a><span class="lineno"> 1884</span><span class="comment">// Define macro GTEST_DONT_DEFINE_ASSERT_XY to 1 to omit the definition of</span></div>
<div class="line"><a id="l01885" name="l01885"></a><span class="lineno"> 1885</span><span class="comment">// ASSERT_XY(), which clashes with some users&#39; own code.</span></div>
<div class="line"><a id="l01886" name="l01886"></a><span class="lineno"> 1886</span> </div>
<div class="line"><a id="l01887" name="l01887"></a><span class="lineno"> 1887</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_EQ</span></div>
<div class="line"><a id="l01888" name="l01888"></a><span class="lineno"> 1888</span><span class="preprocessor">#define ASSERT_EQ(val1, val2) GTEST_ASSERT_EQ(val1, val2)</span></div>
<div class="line"><a id="l01889" name="l01889"></a><span class="lineno"> 1889</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01890" name="l01890"></a><span class="lineno"> 1890</span> </div>
<div class="line"><a id="l01891" name="l01891"></a><span class="lineno"> 1891</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_NE</span></div>
<div class="line"><a id="l01892" name="l01892"></a><span class="lineno"> 1892</span><span class="preprocessor">#define ASSERT_NE(val1, val2) GTEST_ASSERT_NE(val1, val2)</span></div>
<div class="line"><a id="l01893" name="l01893"></a><span class="lineno"> 1893</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01894" name="l01894"></a><span class="lineno"> 1894</span> </div>
<div class="line"><a id="l01895" name="l01895"></a><span class="lineno"> 1895</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_LE</span></div>
<div class="line"><a id="l01896" name="l01896"></a><span class="lineno"> 1896</span><span class="preprocessor">#define ASSERT_LE(val1, val2) GTEST_ASSERT_LE(val1, val2)</span></div>
<div class="line"><a id="l01897" name="l01897"></a><span class="lineno"> 1897</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01898" name="l01898"></a><span class="lineno"> 1898</span> </div>
<div class="line"><a id="l01899" name="l01899"></a><span class="lineno"> 1899</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_LT</span></div>
<div class="line"><a id="l01900" name="l01900"></a><span class="lineno"> 1900</span><span class="preprocessor">#define ASSERT_LT(val1, val2) GTEST_ASSERT_LT(val1, val2)</span></div>
<div class="line"><a id="l01901" name="l01901"></a><span class="lineno"> 1901</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01902" name="l01902"></a><span class="lineno"> 1902</span> </div>
<div class="line"><a id="l01903" name="l01903"></a><span class="lineno"> 1903</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_GE</span></div>
<div class="line"><a id="l01904" name="l01904"></a><span class="lineno"> 1904</span><span class="preprocessor">#define ASSERT_GE(val1, val2) GTEST_ASSERT_GE(val1, val2)</span></div>
<div class="line"><a id="l01905" name="l01905"></a><span class="lineno"> 1905</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01906" name="l01906"></a><span class="lineno"> 1906</span> </div>
<div class="line"><a id="l01907" name="l01907"></a><span class="lineno"> 1907</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_ASSERT_GT</span></div>
<div class="line"><a id="l01908" name="l01908"></a><span class="lineno"> 1908</span><span class="preprocessor">#define ASSERT_GT(val1, val2) GTEST_ASSERT_GT(val1, val2)</span></div>
<div class="line"><a id="l01909" name="l01909"></a><span class="lineno"> 1909</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01910" name="l01910"></a><span class="lineno"> 1910</span> </div>
<div class="line"><a id="l01911" name="l01911"></a><span class="lineno"> 1911</span><span class="comment">// C-string Comparisons.  All tests treat NULL and any non-NULL string</span></div>
<div class="line"><a id="l01912" name="l01912"></a><span class="lineno"> 1912</span><span class="comment">// as different.  Two NULLs are equal.</span></div>
<div class="line"><a id="l01913" name="l01913"></a><span class="lineno"> 1913</span><span class="comment">//</span></div>
<div class="line"><a id="l01914" name="l01914"></a><span class="lineno"> 1914</span><span class="comment">//    * {ASSERT|EXPECT}_STREQ(s1, s2):     Tests that s1 == s2</span></div>
<div class="line"><a id="l01915" name="l01915"></a><span class="lineno"> 1915</span><span class="comment">//    * {ASSERT|EXPECT}_STRNE(s1, s2):     Tests that s1 != s2</span></div>
<div class="line"><a id="l01916" name="l01916"></a><span class="lineno"> 1916</span><span class="comment">//    * {ASSERT|EXPECT}_STRCASEEQ(s1, s2): Tests that s1 == s2, ignoring case</span></div>
<div class="line"><a id="l01917" name="l01917"></a><span class="lineno"> 1917</span><span class="comment">//    * {ASSERT|EXPECT}_STRCASENE(s1, s2): Tests that s1 != s2, ignoring case</span></div>
<div class="line"><a id="l01918" name="l01918"></a><span class="lineno"> 1918</span><span class="comment">//</span></div>
<div class="line"><a id="l01919" name="l01919"></a><span class="lineno"> 1919</span><span class="comment">// For wide or narrow string objects, you can use the</span></div>
<div class="line"><a id="l01920" name="l01920"></a><span class="lineno"> 1920</span><span class="comment">// {ASSERT|EXPECT}_??() macros.</span></div>
<div class="line"><a id="l01921" name="l01921"></a><span class="lineno"> 1921</span><span class="comment">//</span></div>
<div class="line"><a id="l01922" name="l01922"></a><span class="lineno"> 1922</span><span class="comment">// Don&#39;t depend on the order in which the arguments are evaluated,</span></div>
<div class="line"><a id="l01923" name="l01923"></a><span class="lineno"> 1923</span><span class="comment">// which is undefined.</span></div>
<div class="line"><a id="l01924" name="l01924"></a><span class="lineno"> 1924</span><span class="comment">//</span></div>
<div class="line"><a id="l01925" name="l01925"></a><span class="lineno"> 1925</span><span class="comment">// These macros evaluate their arguments exactly once.</span></div>
<div class="line"><a id="l01926" name="l01926"></a><span class="lineno"> 1926</span> </div>
<div class="line"><a id="l01927" name="l01927"></a><span class="lineno"> 1927</span><span class="preprocessor">#define EXPECT_STREQ(s1, s2) \</span></div>
<div class="line"><a id="l01928" name="l01928"></a><span class="lineno"> 1928</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, s1, s2)</span></div>
<div class="line"><a id="l01929" name="l01929"></a><span class="lineno"> 1929</span><span class="preprocessor">#define EXPECT_STRNE(s1, s2) \</span></div>
<div class="line"><a id="l01930" name="l01930"></a><span class="lineno"> 1930</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)</span></div>
<div class="line"><a id="l01931" name="l01931"></a><span class="lineno"> 1931</span><span class="preprocessor">#define EXPECT_STRCASEEQ(s1, s2) \</span></div>
<div class="line"><a id="l01932" name="l01932"></a><span class="lineno"> 1932</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, s1, s2)</span></div>
<div class="line"><a id="l01933" name="l01933"></a><span class="lineno"> 1933</span><span class="preprocessor">#define EXPECT_STRCASENE(s1, s2) \</span></div>
<div class="line"><a id="l01934" name="l01934"></a><span class="lineno"> 1934</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)</span></div>
<div class="line"><a id="l01935" name="l01935"></a><span class="lineno"> 1935</span> </div>
<div class="line"><a id="l01936" name="l01936"></a><span class="lineno"> 1936</span><span class="preprocessor">#define ASSERT_STREQ(s1, s2) \</span></div>
<div class="line"><a id="l01937" name="l01937"></a><span class="lineno"> 1937</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTREQ, s1, s2)</span></div>
<div class="line"><a id="l01938" name="l01938"></a><span class="lineno"> 1938</span><span class="preprocessor">#define ASSERT_STRNE(s1, s2) \</span></div>
<div class="line"><a id="l01939" name="l01939"></a><span class="lineno"> 1939</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRNE, s1, s2)</span></div>
<div class="line"><a id="l01940" name="l01940"></a><span class="lineno"> 1940</span><span class="preprocessor">#define ASSERT_STRCASEEQ(s1, s2) \</span></div>
<div class="line"><a id="l01941" name="l01941"></a><span class="lineno"> 1941</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASEEQ, s1, s2)</span></div>
<div class="line"><a id="l01942" name="l01942"></a><span class="lineno"> 1942</span><span class="preprocessor">#define ASSERT_STRCASENE(s1, s2) \</span></div>
<div class="line"><a id="l01943" name="l01943"></a><span class="lineno"> 1943</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperSTRCASENE, s1, s2)</span></div>
<div class="line"><a id="l01944" name="l01944"></a><span class="lineno"> 1944</span> </div>
<div class="line"><a id="l01945" name="l01945"></a><span class="lineno"> 1945</span><span class="comment">// Macros for comparing floating-point numbers.</span></div>
<div class="line"><a id="l01946" name="l01946"></a><span class="lineno"> 1946</span><span class="comment">//</span></div>
<div class="line"><a id="l01947" name="l01947"></a><span class="lineno"> 1947</span><span class="comment">//    * {ASSERT|EXPECT}_FLOAT_EQ(val1, val2):</span></div>
<div class="line"><a id="l01948" name="l01948"></a><span class="lineno"> 1948</span><span class="comment">//         Tests that two float values are almost equal.</span></div>
<div class="line"><a id="l01949" name="l01949"></a><span class="lineno"> 1949</span><span class="comment">//    * {ASSERT|EXPECT}_DOUBLE_EQ(val1, val2):</span></div>
<div class="line"><a id="l01950" name="l01950"></a><span class="lineno"> 1950</span><span class="comment">//         Tests that two double values are almost equal.</span></div>
<div class="line"><a id="l01951" name="l01951"></a><span class="lineno"> 1951</span><span class="comment">//    * {ASSERT|EXPECT}_NEAR(v1, v2, abs_error):</span></div>
<div class="line"><a id="l01952" name="l01952"></a><span class="lineno"> 1952</span><span class="comment">//         Tests that v1 and v2 are within the given distance to each other.</span></div>
<div class="line"><a id="l01953" name="l01953"></a><span class="lineno"> 1953</span><span class="comment">//</span></div>
<div class="line"><a id="l01954" name="l01954"></a><span class="lineno"> 1954</span><span class="comment">// Google Test uses ULP-based comparison to automatically pick a default</span></div>
<div class="line"><a id="l01955" name="l01955"></a><span class="lineno"> 1955</span><span class="comment">// error bound that is appropriate for the operands.  See the</span></div>
<div class="line"><a id="l01956" name="l01956"></a><span class="lineno"> 1956</span><span class="comment">// FloatingPoint template class in gtest-internal.h if you are</span></div>
<div class="line"><a id="l01957" name="l01957"></a><span class="lineno"> 1957</span><span class="comment">// interested in the implementation details.</span></div>
<div class="line"><a id="l01958" name="l01958"></a><span class="lineno"> 1958</span> </div>
<div class="line"><a id="l01959" name="l01959"></a><span class="lineno"> 1959</span><span class="preprocessor">#define EXPECT_FLOAT_EQ(val1, val2)                                         \</span></div>
<div class="line"><a id="l01960" name="l01960"></a><span class="lineno"> 1960</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ&lt;float&gt;, \</span></div>
<div class="line"><a id="l01961" name="l01961"></a><span class="lineno"> 1961</span><span class="preprocessor">                      val1, val2)</span></div>
<div class="line"><a id="l01962" name="l01962"></a><span class="lineno"> 1962</span> </div>
<div class="line"><a id="l01963" name="l01963"></a><span class="lineno"> 1963</span><span class="preprocessor">#define EXPECT_DOUBLE_EQ(val1, val2)                                         \</span></div>
<div class="line"><a id="l01964" name="l01964"></a><span class="lineno"> 1964</span><span class="preprocessor">  EXPECT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ&lt;double&gt;, \</span></div>
<div class="line"><a id="l01965" name="l01965"></a><span class="lineno"> 1965</span><span class="preprocessor">                      val1, val2)</span></div>
<div class="line"><a id="l01966" name="l01966"></a><span class="lineno"> 1966</span> </div>
<div class="line"><a id="l01967" name="l01967"></a><span class="lineno"> 1967</span><span class="preprocessor">#define ASSERT_FLOAT_EQ(val1, val2)                                         \</span></div>
<div class="line"><a id="l01968" name="l01968"></a><span class="lineno"> 1968</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ&lt;float&gt;, \</span></div>
<div class="line"><a id="l01969" name="l01969"></a><span class="lineno"> 1969</span><span class="preprocessor">                      val1, val2)</span></div>
<div class="line"><a id="l01970" name="l01970"></a><span class="lineno"> 1970</span> </div>
<div class="line"><a id="l01971" name="l01971"></a><span class="lineno"> 1971</span><span class="preprocessor">#define ASSERT_DOUBLE_EQ(val1, val2)                                         \</span></div>
<div class="line"><a id="l01972" name="l01972"></a><span class="lineno"> 1972</span><span class="preprocessor">  ASSERT_PRED_FORMAT2(::testing::internal::CmpHelperFloatingPointEQ&lt;double&gt;, \</span></div>
<div class="line"><a id="l01973" name="l01973"></a><span class="lineno"> 1973</span><span class="preprocessor">                      val1, val2)</span></div>
<div class="line"><a id="l01974" name="l01974"></a><span class="lineno"> 1974</span> </div>
<div class="line"><a id="l01975" name="l01975"></a><span class="lineno"> 1975</span><span class="preprocessor">#define EXPECT_NEAR(val1, val2, abs_error)                                   \</span></div>
<div class="line"><a id="l01976" name="l01976"></a><span class="lineno"> 1976</span><span class="preprocessor">  EXPECT_PRED_FORMAT3(::testing::internal::DoubleNearPredFormat, val1, val2, \</span></div>
<div class="line"><a id="l01977" name="l01977"></a><span class="lineno"> 1977</span><span class="preprocessor">                      abs_error)</span></div>
<div class="line"><a id="l01978" name="l01978"></a><span class="lineno"> 1978</span> </div>
<div class="line"><a id="l01979" name="l01979"></a><span class="lineno"> 1979</span><span class="preprocessor">#define ASSERT_NEAR(val1, val2, abs_error)                                   \</span></div>
<div class="line"><a id="l01980" name="l01980"></a><span class="lineno"> 1980</span><span class="preprocessor">  ASSERT_PRED_FORMAT3(::testing::internal::DoubleNearPredFormat, val1, val2, \</span></div>
<div class="line"><a id="l01981" name="l01981"></a><span class="lineno"> 1981</span><span class="preprocessor">                      abs_error)</span></div>
<div class="line"><a id="l01982" name="l01982"></a><span class="lineno"> 1982</span> </div>
<div class="line"><a id="l01983" name="l01983"></a><span class="lineno"> 1983</span><span class="comment">// These predicate format functions work on floating-point values, and</span></div>
<div class="line"><a id="l01984" name="l01984"></a><span class="lineno"> 1984</span><span class="comment">// can be used in {ASSERT|EXPECT}_PRED_FORMAT2*(), e.g.</span></div>
<div class="line"><a id="l01985" name="l01985"></a><span class="lineno"> 1985</span><span class="comment">//</span></div>
<div class="line"><a id="l01986" name="l01986"></a><span class="lineno"> 1986</span><span class="comment">//   EXPECT_PRED_FORMAT2(testing::DoubleLE, Foo(), 5.0);</span></div>
<div class="line"><a id="l01987" name="l01987"></a><span class="lineno"> 1987</span> </div>
<div class="line"><a id="l01988" name="l01988"></a><span class="lineno"> 1988</span><span class="comment">// Asserts that val1 is less than, or almost equal to, val2.  Fails</span></div>
<div class="line"><a id="l01989" name="l01989"></a><span class="lineno"> 1989</span><span class="comment">// otherwise.  In particular, it fails if either val1 or val2 is NaN.</span></div>
<div class="line"><a id="l01990" name="l01990"></a><span class="lineno"> 1990</span>GTEST_API_ AssertionResult FloatLE(<span class="keyword">const</span> <span class="keywordtype">char</span>* expr1, <span class="keyword">const</span> <span class="keywordtype">char</span>* expr2,</div>
<div class="line"><a id="l01991" name="l01991"></a><span class="lineno"> 1991</span>                                   <span class="keywordtype">float</span> val1, <span class="keywordtype">float</span> val2);</div>
<div class="line"><a id="l01992" name="l01992"></a><span class="lineno"> 1992</span>GTEST_API_ AssertionResult DoubleLE(<span class="keyword">const</span> <span class="keywordtype">char</span>* expr1, <span class="keyword">const</span> <span class="keywordtype">char</span>* expr2,</div>
<div class="line"><a id="l01993" name="l01993"></a><span class="lineno"> 1993</span>                                    <span class="keywordtype">double</span> val1, <span class="keywordtype">double</span> val2);</div>
<div class="line"><a id="l01994" name="l01994"></a><span class="lineno"> 1994</span> </div>
<div class="line"><a id="l01995" name="l01995"></a><span class="lineno"> 1995</span><span class="preprocessor">#if GTEST_OS_WINDOWS</span></div>
<div class="line"><a id="l01996" name="l01996"></a><span class="lineno"> 1996</span> </div>
<div class="line"><a id="l01997" name="l01997"></a><span class="lineno"> 1997</span><span class="comment">// Macros that test for HRESULT failure and success, these are only useful</span></div>
<div class="line"><a id="l01998" name="l01998"></a><span class="lineno"> 1998</span><span class="comment">// on Windows, and rely on Windows SDK macros and APIs to compile.</span></div>
<div class="line"><a id="l01999" name="l01999"></a><span class="lineno"> 1999</span><span class="comment">//</span></div>
<div class="line"><a id="l02000" name="l02000"></a><span class="lineno"> 2000</span><span class="comment">//    * {ASSERT|EXPECT}_HRESULT_{SUCCEEDED|FAILED}(expr)</span></div>
<div class="line"><a id="l02001" name="l02001"></a><span class="lineno"> 2001</span><span class="comment">//</span></div>
<div class="line"><a id="l02002" name="l02002"></a><span class="lineno"> 2002</span><span class="comment">// When expr unexpectedly fails or succeeds, Google Test prints the</span></div>
<div class="line"><a id="l02003" name="l02003"></a><span class="lineno"> 2003</span><span class="comment">// expected result and the actual result with both a human-readable</span></div>
<div class="line"><a id="l02004" name="l02004"></a><span class="lineno"> 2004</span><span class="comment">// string representation of the error, if available, as well as the</span></div>
<div class="line"><a id="l02005" name="l02005"></a><span class="lineno"> 2005</span><span class="comment">// hex result code.</span></div>
<div class="line"><a id="l02006" name="l02006"></a><span class="lineno"> 2006</span><span class="preprocessor">#define EXPECT_HRESULT_SUCCEEDED(expr) \</span></div>
<div class="line"><a id="l02007" name="l02007"></a><span class="lineno"> 2007</span><span class="preprocessor">  EXPECT_PRED_FORMAT1(::testing::internal::IsHRESULTSuccess, (expr))</span></div>
<div class="line"><a id="l02008" name="l02008"></a><span class="lineno"> 2008</span> </div>
<div class="line"><a id="l02009" name="l02009"></a><span class="lineno"> 2009</span><span class="preprocessor">#define ASSERT_HRESULT_SUCCEEDED(expr) \</span></div>
<div class="line"><a id="l02010" name="l02010"></a><span class="lineno"> 2010</span><span class="preprocessor">  ASSERT_PRED_FORMAT1(::testing::internal::IsHRESULTSuccess, (expr))</span></div>
<div class="line"><a id="l02011" name="l02011"></a><span class="lineno"> 2011</span> </div>
<div class="line"><a id="l02012" name="l02012"></a><span class="lineno"> 2012</span><span class="preprocessor">#define EXPECT_HRESULT_FAILED(expr) \</span></div>
<div class="line"><a id="l02013" name="l02013"></a><span class="lineno"> 2013</span><span class="preprocessor">  EXPECT_PRED_FORMAT1(::testing::internal::IsHRESULTFailure, (expr))</span></div>
<div class="line"><a id="l02014" name="l02014"></a><span class="lineno"> 2014</span> </div>
<div class="line"><a id="l02015" name="l02015"></a><span class="lineno"> 2015</span><span class="preprocessor">#define ASSERT_HRESULT_FAILED(expr) \</span></div>
<div class="line"><a id="l02016" name="l02016"></a><span class="lineno"> 2016</span><span class="preprocessor">  ASSERT_PRED_FORMAT1(::testing::internal::IsHRESULTFailure, (expr))</span></div>
<div class="line"><a id="l02017" name="l02017"></a><span class="lineno"> 2017</span> </div>
<div class="line"><a id="l02018" name="l02018"></a><span class="lineno"> 2018</span><span class="preprocessor">#endif  </span><span class="comment">// GTEST_OS_WINDOWS</span></div>
<div class="line"><a id="l02019" name="l02019"></a><span class="lineno"> 2019</span> </div>
<div class="line"><a id="l02020" name="l02020"></a><span class="lineno"> 2020</span><span class="comment">// Macros that execute statement and check that it doesn&#39;t generate new fatal</span></div>
<div class="line"><a id="l02021" name="l02021"></a><span class="lineno"> 2021</span><span class="comment">// failures in the current thread.</span></div>
<div class="line"><a id="l02022" name="l02022"></a><span class="lineno"> 2022</span><span class="comment">//</span></div>
<div class="line"><a id="l02023" name="l02023"></a><span class="lineno"> 2023</span><span class="comment">//   * {ASSERT|EXPECT}_NO_FATAL_FAILURE(statement);</span></div>
<div class="line"><a id="l02024" name="l02024"></a><span class="lineno"> 2024</span><span class="comment">//</span></div>
<div class="line"><a id="l02025" name="l02025"></a><span class="lineno"> 2025</span><span class="comment">// Examples:</span></div>
<div class="line"><a id="l02026" name="l02026"></a><span class="lineno"> 2026</span><span class="comment">//</span></div>
<div class="line"><a id="l02027" name="l02027"></a><span class="lineno"> 2027</span><span class="comment">//   EXPECT_NO_FATAL_FAILURE(Process());</span></div>
<div class="line"><a id="l02028" name="l02028"></a><span class="lineno"> 2028</span><span class="comment">//   ASSERT_NO_FATAL_FAILURE(Process()) &lt;&lt; &quot;Process() failed&quot;;</span></div>
<div class="line"><a id="l02029" name="l02029"></a><span class="lineno"> 2029</span><span class="comment">//</span></div>
<div class="line"><a id="l02030" name="l02030"></a><span class="lineno"> 2030</span><span class="preprocessor">#define ASSERT_NO_FATAL_FAILURE(statement) \</span></div>
<div class="line"><a id="l02031" name="l02031"></a><span class="lineno"> 2031</span><span class="preprocessor">  GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_FATAL_FAILURE_)</span></div>
<div class="line"><a id="l02032" name="l02032"></a><span class="lineno"> 2032</span><span class="preprocessor">#define EXPECT_NO_FATAL_FAILURE(statement) \</span></div>
<div class="line"><a id="l02033" name="l02033"></a><span class="lineno"> 2033</span><span class="preprocessor">  GTEST_TEST_NO_FATAL_FAILURE_(statement, GTEST_NONFATAL_FAILURE_)</span></div>
<div class="line"><a id="l02034" name="l02034"></a><span class="lineno"> 2034</span> </div>
<div class="line"><a id="l02035" name="l02035"></a><span class="lineno"> 2035</span><span class="comment">// Causes a trace (including the given source file path and line number,</span></div>
<div class="line"><a id="l02036" name="l02036"></a><span class="lineno"> 2036</span><span class="comment">// and the given message) to be included in every test failure message generated</span></div>
<div class="line"><a id="l02037" name="l02037"></a><span class="lineno"> 2037</span><span class="comment">// by code in the scope of the lifetime of an instance of this class. The effect</span></div>
<div class="line"><a id="l02038" name="l02038"></a><span class="lineno"> 2038</span><span class="comment">// is undone with the destruction of the instance.</span></div>
<div class="line"><a id="l02039" name="l02039"></a><span class="lineno"> 2039</span><span class="comment">//</span></div>
<div class="line"><a id="l02040" name="l02040"></a><span class="lineno"> 2040</span><span class="comment">// The message argument can be anything streamable to std::ostream.</span></div>
<div class="line"><a id="l02041" name="l02041"></a><span class="lineno"> 2041</span><span class="comment">//</span></div>
<div class="line"><a id="l02042" name="l02042"></a><span class="lineno"> 2042</span><span class="comment">// Example:</span></div>
<div class="line"><a id="l02043" name="l02043"></a><span class="lineno"> 2043</span><span class="comment">//   testing::ScopedTrace trace(&quot;file.cc&quot;, 123, &quot;message&quot;);</span></div>
<div class="line"><a id="l02044" name="l02044"></a><span class="lineno"> 2044</span><span class="comment">//</span></div>
<div class="foldopen" id="foldopen02045" data-start="{" data-end="};">
<div class="line"><a id="l02045" name="l02045"></a><span class="lineno"><a class="line" href="classtesting_1_1_scoped_trace.html"> 2045</a></span><span class="keyword">class </span>GTEST_API_ ScopedTrace {</div>
<div class="line"><a id="l02046" name="l02046"></a><span class="lineno"> 2046</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l02047" name="l02047"></a><span class="lineno"> 2047</span>  <span class="comment">// The c&#39;tor pushes the given source file location and message onto</span></div>
<div class="line"><a id="l02048" name="l02048"></a><span class="lineno"> 2048</span>  <span class="comment">// a trace stack maintained by Google Test.</span></div>
<div class="line"><a id="l02049" name="l02049"></a><span class="lineno"> 2049</span> </div>
<div class="line"><a id="l02050" name="l02050"></a><span class="lineno"> 2050</span>  <span class="comment">// Template version. Uses Message() to convert the values into strings.</span></div>
<div class="line"><a id="l02051" name="l02051"></a><span class="lineno"> 2051</span>  <span class="comment">// Slow, but flexible.</span></div>
<div class="line"><a id="l02052" name="l02052"></a><span class="lineno"> 2052</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt;</div>
<div class="line"><a id="l02053" name="l02053"></a><span class="lineno"> 2053</span>  ScopedTrace(<span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line, <span class="keyword">const</span> T&amp; message) {</div>
<div class="line"><a id="l02054" name="l02054"></a><span class="lineno"> 2054</span>    PushTrace(file, line, (<a class="code hl_class" href="classtesting_1_1_message.html">Message</a>() &lt;&lt; message).GetString());</div>
<div class="line"><a id="l02055" name="l02055"></a><span class="lineno"> 2055</span>  }</div>
<div class="line"><a id="l02056" name="l02056"></a><span class="lineno"> 2056</span> </div>
<div class="line"><a id="l02057" name="l02057"></a><span class="lineno"> 2057</span>  <span class="comment">// Optimize for some known types.</span></div>
<div class="line"><a id="l02058" name="l02058"></a><span class="lineno"> 2058</span>  ScopedTrace(<span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line, <span class="keyword">const</span> <span class="keywordtype">char</span>* message) {</div>
<div class="line"><a id="l02059" name="l02059"></a><span class="lineno"> 2059</span>    PushTrace(file, line, message ? message : <span class="stringliteral">&quot;(null)&quot;</span>);</div>
<div class="line"><a id="l02060" name="l02060"></a><span class="lineno"> 2060</span>  }</div>
<div class="line"><a id="l02061" name="l02061"></a><span class="lineno"> 2061</span> </div>
<div class="line"><a id="l02062" name="l02062"></a><span class="lineno"> 2062</span>  ScopedTrace(<span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line, <span class="keyword">const</span> std::string&amp; message) {</div>
<div class="line"><a id="l02063" name="l02063"></a><span class="lineno"> 2063</span>    PushTrace(file, line, message);</div>
<div class="line"><a id="l02064" name="l02064"></a><span class="lineno"> 2064</span>  }</div>
<div class="line"><a id="l02065" name="l02065"></a><span class="lineno"> 2065</span> </div>
<div class="line"><a id="l02066" name="l02066"></a><span class="lineno"> 2066</span>  <span class="comment">// The d&#39;tor pops the info pushed by the c&#39;tor.</span></div>
<div class="line"><a id="l02067" name="l02067"></a><span class="lineno"> 2067</span>  <span class="comment">//</span></div>
<div class="line"><a id="l02068" name="l02068"></a><span class="lineno"> 2068</span>  <span class="comment">// Note that the d&#39;tor is not virtual in order to be efficient.</span></div>
<div class="line"><a id="l02069" name="l02069"></a><span class="lineno"> 2069</span>  <span class="comment">// Don&#39;t inherit from ScopedTrace!</span></div>
<div class="line"><a id="l02070" name="l02070"></a><span class="lineno"> 2070</span>  ~ScopedTrace();</div>
<div class="line"><a id="l02071" name="l02071"></a><span class="lineno"> 2071</span> </div>
<div class="line"><a id="l02072" name="l02072"></a><span class="lineno"> 2072</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l02073" name="l02073"></a><span class="lineno"> 2073</span>  <span class="keywordtype">void</span> PushTrace(<span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line, std::string message);</div>
<div class="line"><a id="l02074" name="l02074"></a><span class="lineno"> 2074</span> </div>
<div class="line"><a id="l02075" name="l02075"></a><span class="lineno"> 2075</span>  ScopedTrace(<span class="keyword">const</span> ScopedTrace&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l02076" name="l02076"></a><span class="lineno"> 2076</span>  ScopedTrace&amp; operator=(<span class="keyword">const</span> ScopedTrace&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l02077" name="l02077"></a><span class="lineno"> 2077</span>} GTEST_ATTRIBUTE_UNUSED_;  <span class="comment">// A ScopedTrace object does its job in its</span></div>
</div>
<div class="line"><a id="l02078" name="l02078"></a><span class="lineno"> 2078</span>                            <span class="comment">// c&#39;tor and d&#39;tor.  Therefore it doesn&#39;t</span></div>
<div class="line"><a id="l02079" name="l02079"></a><span class="lineno"> 2079</span>                            <span class="comment">// need to be used otherwise.</span></div>
<div class="line"><a id="l02080" name="l02080"></a><span class="lineno"> 2080</span> </div>
<div class="line"><a id="l02081" name="l02081"></a><span class="lineno"> 2081</span><span class="comment">// Causes a trace (including the source file path, the current line</span></div>
<div class="line"><a id="l02082" name="l02082"></a><span class="lineno"> 2082</span><span class="comment">// number, and the given message) to be included in every test failure</span></div>
<div class="line"><a id="l02083" name="l02083"></a><span class="lineno"> 2083</span><span class="comment">// message generated by code in the current scope.  The effect is</span></div>
<div class="line"><a id="l02084" name="l02084"></a><span class="lineno"> 2084</span><span class="comment">// undone when the control leaves the current scope.</span></div>
<div class="line"><a id="l02085" name="l02085"></a><span class="lineno"> 2085</span><span class="comment">//</span></div>
<div class="line"><a id="l02086" name="l02086"></a><span class="lineno"> 2086</span><span class="comment">// The message argument can be anything streamable to std::ostream.</span></div>
<div class="line"><a id="l02087" name="l02087"></a><span class="lineno"> 2087</span><span class="comment">//</span></div>
<div class="line"><a id="l02088" name="l02088"></a><span class="lineno"> 2088</span><span class="comment">// In the implementation, we include the current line number as part</span></div>
<div class="line"><a id="l02089" name="l02089"></a><span class="lineno"> 2089</span><span class="comment">// of the dummy variable name, thus allowing multiple SCOPED_TRACE()s</span></div>
<div class="line"><a id="l02090" name="l02090"></a><span class="lineno"> 2090</span><span class="comment">// to appear in the same block - as long as they are on different</span></div>
<div class="line"><a id="l02091" name="l02091"></a><span class="lineno"> 2091</span><span class="comment">// lines.</span></div>
<div class="line"><a id="l02092" name="l02092"></a><span class="lineno"> 2092</span><span class="comment">//</span></div>
<div class="line"><a id="l02093" name="l02093"></a><span class="lineno"> 2093</span><span class="comment">// Assuming that each thread maintains its own stack of traces.</span></div>
<div class="line"><a id="l02094" name="l02094"></a><span class="lineno"> 2094</span><span class="comment">// Therefore, a SCOPED_TRACE() would (correctly) only affect the</span></div>
<div class="line"><a id="l02095" name="l02095"></a><span class="lineno"> 2095</span><span class="comment">// assertions in its own thread.</span></div>
<div class="line"><a id="l02096" name="l02096"></a><span class="lineno"> 2096</span><span class="preprocessor">#define SCOPED_TRACE(message)                                         \</span></div>
<div class="line"><a id="l02097" name="l02097"></a><span class="lineno"> 2097</span><span class="preprocessor">  ::testing::ScopedTrace GTEST_CONCAT_TOKEN_(gtest_trace_, __LINE__)( \</span></div>
<div class="line"><a id="l02098" name="l02098"></a><span class="lineno"> 2098</span><span class="preprocessor">      __FILE__, __LINE__, (message))</span></div>
<div class="line"><a id="l02099" name="l02099"></a><span class="lineno"> 2099</span> </div>
<div class="line"><a id="l02100" name="l02100"></a><span class="lineno"> 2100</span><span class="comment">// Compile-time assertion for type equality.</span></div>
<div class="line"><a id="l02101" name="l02101"></a><span class="lineno"> 2101</span><span class="comment">// StaticAssertTypeEq&lt;type1, type2&gt;() compiles if and only if type1 and type2</span></div>
<div class="line"><a id="l02102" name="l02102"></a><span class="lineno"> 2102</span><span class="comment">// are the same type.  The value it returns is not interesting.</span></div>
<div class="line"><a id="l02103" name="l02103"></a><span class="lineno"> 2103</span><span class="comment">//</span></div>
<div class="line"><a id="l02104" name="l02104"></a><span class="lineno"> 2104</span><span class="comment">// Instead of making StaticAssertTypeEq a class template, we make it a</span></div>
<div class="line"><a id="l02105" name="l02105"></a><span class="lineno"> 2105</span><span class="comment">// function template that invokes a helper class template.  This</span></div>
<div class="line"><a id="l02106" name="l02106"></a><span class="lineno"> 2106</span><span class="comment">// prevents a user from misusing StaticAssertTypeEq&lt;T1, T2&gt; by</span></div>
<div class="line"><a id="l02107" name="l02107"></a><span class="lineno"> 2107</span><span class="comment">// defining objects of that type.</span></div>
<div class="line"><a id="l02108" name="l02108"></a><span class="lineno"> 2108</span><span class="comment">//</span></div>
<div class="line"><a id="l02109" name="l02109"></a><span class="lineno"> 2109</span><span class="comment">// CAVEAT:</span></div>
<div class="line"><a id="l02110" name="l02110"></a><span class="lineno"> 2110</span><span class="comment">//</span></div>
<div class="line"><a id="l02111" name="l02111"></a><span class="lineno"> 2111</span><span class="comment">// When used inside a method of a class template,</span></div>
<div class="line"><a id="l02112" name="l02112"></a><span class="lineno"> 2112</span><span class="comment">// StaticAssertTypeEq&lt;T1, T2&gt;() is effective ONLY IF the method is</span></div>
<div class="line"><a id="l02113" name="l02113"></a><span class="lineno"> 2113</span><span class="comment">// instantiated.  For example, given:</span></div>
<div class="line"><a id="l02114" name="l02114"></a><span class="lineno"> 2114</span><span class="comment">//</span></div>
<div class="line"><a id="l02115" name="l02115"></a><span class="lineno"> 2115</span><span class="comment">//   template &lt;typename T&gt; class Foo {</span></div>
<div class="line"><a id="l02116" name="l02116"></a><span class="lineno"> 2116</span><span class="comment">//    public:</span></div>
<div class="line"><a id="l02117" name="l02117"></a><span class="lineno"> 2117</span><span class="comment">//     void Bar() { testing::StaticAssertTypeEq&lt;int, T&gt;(); }</span></div>
<div class="line"><a id="l02118" name="l02118"></a><span class="lineno"> 2118</span><span class="comment">//   };</span></div>
<div class="line"><a id="l02119" name="l02119"></a><span class="lineno"> 2119</span><span class="comment">//</span></div>
<div class="line"><a id="l02120" name="l02120"></a><span class="lineno"> 2120</span><span class="comment">// the code:</span></div>
<div class="line"><a id="l02121" name="l02121"></a><span class="lineno"> 2121</span><span class="comment">//</span></div>
<div class="line"><a id="l02122" name="l02122"></a><span class="lineno"> 2122</span><span class="comment">//   void Test1() { Foo&lt;bool&gt; foo; }</span></div>
<div class="line"><a id="l02123" name="l02123"></a><span class="lineno"> 2123</span><span class="comment">//</span></div>
<div class="line"><a id="l02124" name="l02124"></a><span class="lineno"> 2124</span><span class="comment">// will NOT generate a compiler error, as Foo&lt;bool&gt;::Bar() is never</span></div>
<div class="line"><a id="l02125" name="l02125"></a><span class="lineno"> 2125</span><span class="comment">// actually instantiated.  Instead, you need:</span></div>
<div class="line"><a id="l02126" name="l02126"></a><span class="lineno"> 2126</span><span class="comment">//</span></div>
<div class="line"><a id="l02127" name="l02127"></a><span class="lineno"> 2127</span><span class="comment">//   void Test2() { Foo&lt;bool&gt; foo; foo.Bar(); }</span></div>
<div class="line"><a id="l02128" name="l02128"></a><span class="lineno"> 2128</span><span class="comment">//</span></div>
<div class="line"><a id="l02129" name="l02129"></a><span class="lineno"> 2129</span><span class="comment">// to cause a compiler error.</span></div>
<div class="line"><a id="l02130" name="l02130"></a><span class="lineno"> 2130</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T1, <span class="keyword">typename</span> T2&gt;</div>
<div class="line"><a id="l02131" name="l02131"></a><span class="lineno"> 2131</span><span class="keyword">constexpr</span> <span class="keywordtype">bool</span> StaticAssertTypeEq() noexcept {</div>
<div class="line"><a id="l02132" name="l02132"></a><span class="lineno"> 2132</span>  <span class="keyword">static_assert</span>(std::is_same&lt;T1, T2&gt;::value, <span class="stringliteral">&quot;T1 and T2 are not the same type&quot;</span>);</div>
<div class="line"><a id="l02133" name="l02133"></a><span class="lineno"> 2133</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div>
<div class="line"><a id="l02134" name="l02134"></a><span class="lineno"> 2134</span>}</div>
<div class="line"><a id="l02135" name="l02135"></a><span class="lineno"> 2135</span> </div>
<div class="line"><a id="l02136" name="l02136"></a><span class="lineno"> 2136</span><span class="comment">// Defines a test.</span></div>
<div class="line"><a id="l02137" name="l02137"></a><span class="lineno"> 2137</span><span class="comment">//</span></div>
<div class="line"><a id="l02138" name="l02138"></a><span class="lineno"> 2138</span><span class="comment">// The first parameter is the name of the test suite, and the second</span></div>
<div class="line"><a id="l02139" name="l02139"></a><span class="lineno"> 2139</span><span class="comment">// parameter is the name of the test within the test suite.</span></div>
<div class="line"><a id="l02140" name="l02140"></a><span class="lineno"> 2140</span><span class="comment">//</span></div>
<div class="line"><a id="l02141" name="l02141"></a><span class="lineno"> 2141</span><span class="comment">// The convention is to end the test suite name with &quot;Test&quot;.  For</span></div>
<div class="line"><a id="l02142" name="l02142"></a><span class="lineno"> 2142</span><span class="comment">// example, a test suite for the Foo class can be named FooTest.</span></div>
<div class="line"><a id="l02143" name="l02143"></a><span class="lineno"> 2143</span><span class="comment">//</span></div>
<div class="line"><a id="l02144" name="l02144"></a><span class="lineno"> 2144</span><span class="comment">// Test code should appear between braces after an invocation of</span></div>
<div class="line"><a id="l02145" name="l02145"></a><span class="lineno"> 2145</span><span class="comment">// this macro.  Example:</span></div>
<div class="line"><a id="l02146" name="l02146"></a><span class="lineno"> 2146</span><span class="comment">//</span></div>
<div class="line"><a id="l02147" name="l02147"></a><span class="lineno"> 2147</span><span class="comment">//   TEST(FooTest, InitializesCorrectly) {</span></div>
<div class="line"><a id="l02148" name="l02148"></a><span class="lineno"> 2148</span><span class="comment">//     Foo foo;</span></div>
<div class="line"><a id="l02149" name="l02149"></a><span class="lineno"> 2149</span><span class="comment">//     EXPECT_TRUE(foo.StatusIsOK());</span></div>
<div class="line"><a id="l02150" name="l02150"></a><span class="lineno"> 2150</span><span class="comment">//   }</span></div>
<div class="line"><a id="l02151" name="l02151"></a><span class="lineno"> 2151</span> </div>
<div class="line"><a id="l02152" name="l02152"></a><span class="lineno"> 2152</span><span class="comment">// Note that we call GetTestTypeId() instead of GetTypeId&lt;</span></div>
<div class="line"><a id="l02153" name="l02153"></a><span class="lineno"> 2153</span><span class="comment">// ::testing::Test&gt;() here to get the type ID of testing::Test.  This</span></div>
<div class="line"><a id="l02154" name="l02154"></a><span class="lineno"> 2154</span><span class="comment">// is to work around a suspected linker bug when using Google Test as</span></div>
<div class="line"><a id="l02155" name="l02155"></a><span class="lineno"> 2155</span><span class="comment">// a framework on Mac OS X.  The bug causes GetTypeId&lt;</span></div>
<div class="line"><a id="l02156" name="l02156"></a><span class="lineno"> 2156</span><span class="comment">// ::testing::Test&gt;() to return different values depending on whether</span></div>
<div class="line"><a id="l02157" name="l02157"></a><span class="lineno"> 2157</span><span class="comment">// the call is from the Google Test framework itself or from user test</span></div>
<div class="line"><a id="l02158" name="l02158"></a><span class="lineno"> 2158</span><span class="comment">// code.  GetTestTypeId() is guaranteed to always return the same</span></div>
<div class="line"><a id="l02159" name="l02159"></a><span class="lineno"> 2159</span><span class="comment">// value, as it always calls GetTypeId&lt;&gt;() from the Google Test</span></div>
<div class="line"><a id="l02160" name="l02160"></a><span class="lineno"> 2160</span><span class="comment">// framework.</span></div>
<div class="line"><a id="l02161" name="l02161"></a><span class="lineno"> 2161</span><span class="preprocessor">#define GTEST_TEST(test_suite_name, test_name)             \</span></div>
<div class="line"><a id="l02162" name="l02162"></a><span class="lineno"> 2162</span><span class="preprocessor">  GTEST_TEST_(test_suite_name, test_name, ::testing::Test, \</span></div>
<div class="line"><a id="l02163" name="l02163"></a><span class="lineno"> 2163</span><span class="preprocessor">              ::testing::internal::GetTestTypeId())</span></div>
<div class="line"><a id="l02164" name="l02164"></a><span class="lineno"> 2164</span> </div>
<div class="line"><a id="l02165" name="l02165"></a><span class="lineno"> 2165</span><span class="comment">// Define this macro to 1 to omit the definition of TEST(), which</span></div>
<div class="line"><a id="l02166" name="l02166"></a><span class="lineno"> 2166</span><span class="comment">// is a generic name and clashes with some other libraries.</span></div>
<div class="line"><a id="l02167" name="l02167"></a><span class="lineno"> 2167</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_TEST</span></div>
<div class="line"><a id="l02168" name="l02168"></a><span class="lineno"> 2168</span><span class="preprocessor">#define TEST(test_suite_name, test_name) GTEST_TEST(test_suite_name, test_name)</span></div>
<div class="line"><a id="l02169" name="l02169"></a><span class="lineno"> 2169</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l02170" name="l02170"></a><span class="lineno"> 2170</span> </div>
<div class="line"><a id="l02171" name="l02171"></a><span class="lineno"> 2171</span><span class="comment">// Defines a test that uses a test fixture.</span></div>
<div class="line"><a id="l02172" name="l02172"></a><span class="lineno"> 2172</span><span class="comment">//</span></div>
<div class="line"><a id="l02173" name="l02173"></a><span class="lineno"> 2173</span><span class="comment">// The first parameter is the name of the test fixture class, which</span></div>
<div class="line"><a id="l02174" name="l02174"></a><span class="lineno"> 2174</span><span class="comment">// also doubles as the test suite name.  The second parameter is the</span></div>
<div class="line"><a id="l02175" name="l02175"></a><span class="lineno"> 2175</span><span class="comment">// name of the test within the test suite.</span></div>
<div class="line"><a id="l02176" name="l02176"></a><span class="lineno"> 2176</span><span class="comment">//</span></div>
<div class="line"><a id="l02177" name="l02177"></a><span class="lineno"> 2177</span><span class="comment">// A test fixture class must be declared earlier.  The user should put</span></div>
<div class="line"><a id="l02178" name="l02178"></a><span class="lineno"> 2178</span><span class="comment">// the test code between braces after using this macro.  Example:</span></div>
<div class="line"><a id="l02179" name="l02179"></a><span class="lineno"> 2179</span><span class="comment">//</span></div>
<div class="line"><a id="l02180" name="l02180"></a><span class="lineno"> 2180</span><span class="comment">//   class FooTest : public testing::Test {</span></div>
<div class="line"><a id="l02181" name="l02181"></a><span class="lineno"> 2181</span><span class="comment">//    protected:</span></div>
<div class="line"><a id="l02182" name="l02182"></a><span class="lineno"> 2182</span><span class="comment">//     void SetUp() override { b_.AddElement(3); }</span></div>
<div class="line"><a id="l02183" name="l02183"></a><span class="lineno"> 2183</span><span class="comment">//</span></div>
<div class="line"><a id="l02184" name="l02184"></a><span class="lineno"> 2184</span><span class="comment">//     Foo a_;</span></div>
<div class="line"><a id="l02185" name="l02185"></a><span class="lineno"> 2185</span><span class="comment">//     Foo b_;</span></div>
<div class="line"><a id="l02186" name="l02186"></a><span class="lineno"> 2186</span><span class="comment">//   };</span></div>
<div class="line"><a id="l02187" name="l02187"></a><span class="lineno"> 2187</span><span class="comment">//</span></div>
<div class="line"><a id="l02188" name="l02188"></a><span class="lineno"> 2188</span><span class="comment">//   TEST_F(FooTest, InitializesCorrectly) {</span></div>
<div class="line"><a id="l02189" name="l02189"></a><span class="lineno"> 2189</span><span class="comment">//     EXPECT_TRUE(a_.StatusIsOK());</span></div>
<div class="line"><a id="l02190" name="l02190"></a><span class="lineno"> 2190</span><span class="comment">//   }</span></div>
<div class="line"><a id="l02191" name="l02191"></a><span class="lineno"> 2191</span><span class="comment">//</span></div>
<div class="line"><a id="l02192" name="l02192"></a><span class="lineno"> 2192</span><span class="comment">//   TEST_F(FooTest, ReturnsElementCountCorrectly) {</span></div>
<div class="line"><a id="l02193" name="l02193"></a><span class="lineno"> 2193</span><span class="comment">//     EXPECT_EQ(a_.size(), 0);</span></div>
<div class="line"><a id="l02194" name="l02194"></a><span class="lineno"> 2194</span><span class="comment">//     EXPECT_EQ(b_.size(), 1);</span></div>
<div class="line"><a id="l02195" name="l02195"></a><span class="lineno"> 2195</span><span class="comment">//   }</span></div>
<div class="line"><a id="l02196" name="l02196"></a><span class="lineno"> 2196</span><span class="preprocessor">#define GTEST_TEST_F(test_fixture, test_name)        \</span></div>
<div class="line"><a id="l02197" name="l02197"></a><span class="lineno"> 2197</span><span class="preprocessor">  GTEST_TEST_(test_fixture, test_name, test_fixture, \</span></div>
<div class="line"><a id="l02198" name="l02198"></a><span class="lineno"> 2198</span><span class="preprocessor">              ::testing::internal::GetTypeId&lt;test_fixture&gt;())</span></div>
<div class="line"><a id="l02199" name="l02199"></a><span class="lineno"> 2199</span><span class="preprocessor">#if !GTEST_DONT_DEFINE_TEST_F</span></div>
<div class="line"><a id="l02200" name="l02200"></a><span class="lineno"> 2200</span><span class="preprocessor">#define TEST_F(test_fixture, test_name) GTEST_TEST_F(test_fixture, test_name)</span></div>
<div class="line"><a id="l02201" name="l02201"></a><span class="lineno"> 2201</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l02202" name="l02202"></a><span class="lineno"> 2202</span> </div>
<div class="line"><a id="l02203" name="l02203"></a><span class="lineno"> 2203</span><span class="comment">// Returns a path to temporary directory.</span></div>
<div class="line"><a id="l02204" name="l02204"></a><span class="lineno"> 2204</span><span class="comment">// Tries to determine an appropriate directory for the platform.</span></div>
<div class="line"><a id="l02205" name="l02205"></a><span class="lineno"> 2205</span>GTEST_API_ std::string TempDir();</div>
<div class="line"><a id="l02206" name="l02206"></a><span class="lineno"> 2206</span> </div>
<div class="line"><a id="l02207" name="l02207"></a><span class="lineno"> 2207</span><span class="preprocessor">#ifdef _MSC_VER</span></div>
<div class="line"><a id="l02208" name="l02208"></a><span class="lineno"> 2208</span><span class="preprocessor">#pragma warning(pop)</span></div>
<div class="line"><a id="l02209" name="l02209"></a><span class="lineno"> 2209</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l02210" name="l02210"></a><span class="lineno"> 2210</span> </div>
<div class="line"><a id="l02211" name="l02211"></a><span class="lineno"> 2211</span><span class="comment">// Dynamically registers a test with the framework.</span></div>
<div class="line"><a id="l02212" name="l02212"></a><span class="lineno"> 2212</span><span class="comment">//</span></div>
<div class="line"><a id="l02213" name="l02213"></a><span class="lineno"> 2213</span><span class="comment">// This is an advanced API only to be used when the `TEST` macros are</span></div>
<div class="line"><a id="l02214" name="l02214"></a><span class="lineno"> 2214</span><span class="comment">// insufficient. The macros should be preferred when possible, as they avoid</span></div>
<div class="line"><a id="l02215" name="l02215"></a><span class="lineno"> 2215</span><span class="comment">// most of the complexity of calling this function.</span></div>
<div class="line"><a id="l02216" name="l02216"></a><span class="lineno"> 2216</span><span class="comment">//</span></div>
<div class="line"><a id="l02217" name="l02217"></a><span class="lineno"> 2217</span><span class="comment">// The `factory` argument is a factory callable (move-constructible) object or</span></div>
<div class="line"><a id="l02218" name="l02218"></a><span class="lineno"> 2218</span><span class="comment">// function pointer that creates a new instance of the Test object. It</span></div>
<div class="line"><a id="l02219" name="l02219"></a><span class="lineno"> 2219</span><span class="comment">// handles ownership to the caller. The signature of the callable is</span></div>
<div class="line"><a id="l02220" name="l02220"></a><span class="lineno"> 2220</span><span class="comment">// `Fixture*()`, where `Fixture` is the test fixture class for the test. All</span></div>
<div class="line"><a id="l02221" name="l02221"></a><span class="lineno"> 2221</span><span class="comment">// tests registered with the same `test_suite_name` must return the same</span></div>
<div class="line"><a id="l02222" name="l02222"></a><span class="lineno"> 2222</span><span class="comment">// fixture type. This is checked at runtime.</span></div>
<div class="line"><a id="l02223" name="l02223"></a><span class="lineno"> 2223</span><span class="comment">//</span></div>
<div class="line"><a id="l02224" name="l02224"></a><span class="lineno"> 2224</span><span class="comment">// The framework will infer the fixture class from the factory and will call</span></div>
<div class="line"><a id="l02225" name="l02225"></a><span class="lineno"> 2225</span><span class="comment">// the `SetUpTestSuite` and `TearDownTestSuite` for it.</span></div>
<div class="line"><a id="l02226" name="l02226"></a><span class="lineno"> 2226</span><span class="comment">//</span></div>
<div class="line"><a id="l02227" name="l02227"></a><span class="lineno"> 2227</span><span class="comment">// Must be called before `RUN_ALL_TESTS()` is invoked, otherwise behavior is</span></div>
<div class="line"><a id="l02228" name="l02228"></a><span class="lineno"> 2228</span><span class="comment">// undefined.</span></div>
<div class="line"><a id="l02229" name="l02229"></a><span class="lineno"> 2229</span><span class="comment">//</span></div>
<div class="line"><a id="l02230" name="l02230"></a><span class="lineno"> 2230</span><span class="comment">// Use case example:</span></div>
<div class="line"><a id="l02231" name="l02231"></a><span class="lineno"> 2231</span><span class="comment">//</span></div>
<div class="line"><a id="l02232" name="l02232"></a><span class="lineno"> 2232</span><span class="comment">// class MyFixture : public ::testing::Test {</span></div>
<div class="line"><a id="l02233" name="l02233"></a><span class="lineno"> 2233</span><span class="comment">//  public:</span></div>
<div class="line"><a id="l02234" name="l02234"></a><span class="lineno"> 2234</span><span class="comment">//   // All of these optional, just like in regular macro usage.</span></div>
<div class="line"><a id="l02235" name="l02235"></a><span class="lineno"> 2235</span><span class="comment">//   static void SetUpTestSuite() { ... }</span></div>
<div class="line"><a id="l02236" name="l02236"></a><span class="lineno"> 2236</span><span class="comment">//   static void TearDownTestSuite() { ... }</span></div>
<div class="line"><a id="l02237" name="l02237"></a><span class="lineno"> 2237</span><span class="comment">//   void SetUp() override { ... }</span></div>
<div class="line"><a id="l02238" name="l02238"></a><span class="lineno"> 2238</span><span class="comment">//   void TearDown() override { ... }</span></div>
<div class="line"><a id="l02239" name="l02239"></a><span class="lineno"> 2239</span><span class="comment">// };</span></div>
<div class="line"><a id="l02240" name="l02240"></a><span class="lineno"> 2240</span><span class="comment">//</span></div>
<div class="line"><a id="l02241" name="l02241"></a><span class="lineno"> 2241</span><span class="comment">// class MyTest : public MyFixture {</span></div>
<div class="line"><a id="l02242" name="l02242"></a><span class="lineno"> 2242</span><span class="comment">//  public:</span></div>
<div class="line"><a id="l02243" name="l02243"></a><span class="lineno"> 2243</span><span class="comment">//   explicit MyTest(int data) : data_(data) {}</span></div>
<div class="line"><a id="l02244" name="l02244"></a><span class="lineno"> 2244</span><span class="comment">//   void TestBody() override { ... }</span></div>
<div class="line"><a id="l02245" name="l02245"></a><span class="lineno"> 2245</span><span class="comment">//</span></div>
<div class="line"><a id="l02246" name="l02246"></a><span class="lineno"> 2246</span><span class="comment">//  private:</span></div>
<div class="line"><a id="l02247" name="l02247"></a><span class="lineno"> 2247</span><span class="comment">//   int data_;</span></div>
<div class="line"><a id="l02248" name="l02248"></a><span class="lineno"> 2248</span><span class="comment">// };</span></div>
<div class="line"><a id="l02249" name="l02249"></a><span class="lineno"> 2249</span><span class="comment">//</span></div>
<div class="line"><a id="l02250" name="l02250"></a><span class="lineno"> 2250</span><span class="comment">// void RegisterMyTests(const std::vector&lt;int&gt;&amp; values) {</span></div>
<div class="line"><a id="l02251" name="l02251"></a><span class="lineno"> 2251</span><span class="comment">//   for (int v : values) {</span></div>
<div class="line"><a id="l02252" name="l02252"></a><span class="lineno"> 2252</span><span class="comment">//     ::testing::RegisterTest(</span></div>
<div class="line"><a id="l02253" name="l02253"></a><span class="lineno"> 2253</span><span class="comment">//         &quot;MyFixture&quot;, (&quot;Test&quot; + std::to_string(v)).c_str(), nullptr,</span></div>
<div class="line"><a id="l02254" name="l02254"></a><span class="lineno"> 2254</span><span class="comment">//         std::to_string(v).c_str(),</span></div>
<div class="line"><a id="l02255" name="l02255"></a><span class="lineno"> 2255</span><span class="comment">//         __FILE__, __LINE__,</span></div>
<div class="line"><a id="l02256" name="l02256"></a><span class="lineno"> 2256</span><span class="comment">//         // Important to use the fixture type as the return type here.</span></div>
<div class="line"><a id="l02257" name="l02257"></a><span class="lineno"> 2257</span><span class="comment">//         [=]() -&gt; MyFixture* { return new MyTest(v); });</span></div>
<div class="line"><a id="l02258" name="l02258"></a><span class="lineno"> 2258</span><span class="comment">//   }</span></div>
<div class="line"><a id="l02259" name="l02259"></a><span class="lineno"> 2259</span><span class="comment">// }</span></div>
<div class="line"><a id="l02260" name="l02260"></a><span class="lineno"> 2260</span><span class="comment">// ...</span></div>
<div class="line"><a id="l02261" name="l02261"></a><span class="lineno"> 2261</span><span class="comment">// int main(int argc, char** argv) {</span></div>
<div class="line"><a id="l02262" name="l02262"></a><span class="lineno"> 2262</span><span class="comment">//   ::testing::InitGoogleTest(&amp;argc, argv);</span></div>
<div class="line"><a id="l02263" name="l02263"></a><span class="lineno"> 2263</span><span class="comment">//   std::vector&lt;int&gt; values_to_test = LoadValuesFromConfig();</span></div>
<div class="line"><a id="l02264" name="l02264"></a><span class="lineno"> 2264</span><span class="comment">//   RegisterMyTests(values_to_test);</span></div>
<div class="line"><a id="l02265" name="l02265"></a><span class="lineno"> 2265</span><span class="comment">//   ...</span></div>
<div class="line"><a id="l02266" name="l02266"></a><span class="lineno"> 2266</span><span class="comment">//   return RUN_ALL_TESTS();</span></div>
<div class="line"><a id="l02267" name="l02267"></a><span class="lineno"> 2267</span><span class="comment">// }</span></div>
<div class="line"><a id="l02268" name="l02268"></a><span class="lineno"> 2268</span><span class="comment">//</span></div>
<div class="line"><a id="l02269" name="l02269"></a><span class="lineno"> 2269</span><span class="keyword">template</span> &lt;<span class="keywordtype">int</span>&amp;... ExplicitParameterBarrier, <span class="keyword">typename</span> Factory&gt;</div>
<div class="line"><a id="l02270" name="l02270"></a><span class="lineno"> 2270</span><a class="code hl_class" href="class_test_info.html">TestInfo</a>* RegisterTest(<span class="keyword">const</span> <span class="keywordtype">char</span>* test_suite_name, <span class="keyword">const</span> <span class="keywordtype">char</span>* test_name,</div>
<div class="line"><a id="l02271" name="l02271"></a><span class="lineno"> 2271</span>                       <span class="keyword">const</span> <span class="keywordtype">char</span>* type_param, <span class="keyword">const</span> <span class="keywordtype">char</span>* value_param,</div>
<div class="line"><a id="l02272" name="l02272"></a><span class="lineno"> 2272</span>                       <span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line, Factory factory) {</div>
<div class="line"><a id="l02273" name="l02273"></a><span class="lineno"> 2273</span>  <span class="keyword">using </span>TestT = <span class="keyword">typename</span> std::remove_pointer&lt;<span class="keyword">decltype</span>(factory())&gt;::type;</div>
<div class="line"><a id="l02274" name="l02274"></a><span class="lineno"> 2274</span> </div>
<div class="line"><a id="l02275" name="l02275"></a><span class="lineno"> 2275</span>  <span class="keyword">class </span>FactoryImpl : <span class="keyword">public</span> internal::TestFactoryBase {</div>
<div class="line"><a id="l02276" name="l02276"></a><span class="lineno"> 2276</span>   <span class="keyword">public</span>:</div>
<div class="line"><a id="l02277" name="l02277"></a><span class="lineno"> 2277</span>    <span class="keyword">explicit</span> FactoryImpl(Factory f) : factory_(std::move(f)) {}</div>
<div class="line"><a id="l02278" name="l02278"></a><span class="lineno"> 2278</span>    Test* CreateTest()<span class="keyword"> override </span>{ <span class="keywordflow">return</span> factory_(); }</div>
<div class="line"><a id="l02279" name="l02279"></a><span class="lineno"> 2279</span> </div>
<div class="line"><a id="l02280" name="l02280"></a><span class="lineno"> 2280</span>   <span class="keyword">private</span>:</div>
<div class="line"><a id="l02281" name="l02281"></a><span class="lineno"> 2281</span>    Factory factory_;</div>
<div class="line"><a id="l02282" name="l02282"></a><span class="lineno"> 2282</span>  };</div>
<div class="line"><a id="l02283" name="l02283"></a><span class="lineno"> 2283</span> </div>
<div class="line"><a id="l02284" name="l02284"></a><span class="lineno"> 2284</span>  <span class="keywordflow">return</span> internal::MakeAndRegisterTestInfo(</div>
<div class="line"><a id="l02285" name="l02285"></a><span class="lineno"> 2285</span>      test_suite_name, test_name, type_param, value_param,</div>
<div class="line"><a id="l02286" name="l02286"></a><span class="lineno"> 2286</span>      <a class="code hl_struct" href="structtesting_1_1internal_1_1_code_location.html">internal::CodeLocation</a>(file, line), internal::GetTypeId&lt;TestT&gt;(),</div>
<div class="line"><a id="l02287" name="l02287"></a><span class="lineno"> 2287</span>      internal::SuiteApiResolver&lt;TestT&gt;::GetSetUpCaseOrSuite(file, line),</div>
<div class="line"><a id="l02288" name="l02288"></a><span class="lineno"> 2288</span>      internal::SuiteApiResolver&lt;TestT&gt;::GetTearDownCaseOrSuite(file, line),</div>
<div class="line"><a id="l02289" name="l02289"></a><span class="lineno"> 2289</span>      <span class="keyword">new</span> FactoryImpl{std::move(factory)});</div>
<div class="line"><a id="l02290" name="l02290"></a><span class="lineno"> 2290</span>}</div>
<div class="line"><a id="l02291" name="l02291"></a><span class="lineno"> 2291</span> </div>
<div class="line"><a id="l02292" name="l02292"></a><span class="lineno"> 2292</span>}  <span class="comment">// namespace testing</span></div>
<div class="line"><a id="l02293" name="l02293"></a><span class="lineno"> 2293</span> </div>
<div class="line"><a id="l02294" name="l02294"></a><span class="lineno"> 2294</span><span class="comment">// Use this function in main() to run all tests.  It returns 0 if all</span></div>
<div class="line"><a id="l02295" name="l02295"></a><span class="lineno"> 2295</span><span class="comment">// tests are successful, or 1 otherwise.</span></div>
<div class="line"><a id="l02296" name="l02296"></a><span class="lineno"> 2296</span><span class="comment">//</span></div>
<div class="line"><a id="l02297" name="l02297"></a><span class="lineno"> 2297</span><span class="comment">// RUN_ALL_TESTS() should be invoked after the command line has been</span></div>
<div class="line"><a id="l02298" name="l02298"></a><span class="lineno"> 2298</span><span class="comment">// parsed by InitGoogleTest().</span></div>
<div class="line"><a id="l02299" name="l02299"></a><span class="lineno"> 2299</span><span class="comment">//</span></div>
<div class="line"><a id="l02300" name="l02300"></a><span class="lineno"> 2300</span><span class="comment">// This function was formerly a macro; thus, it is in the global</span></div>
<div class="line"><a id="l02301" name="l02301"></a><span class="lineno"> 2301</span><span class="comment">// namespace and has an all-caps name.</span></div>
<div class="line"><a id="l02302" name="l02302"></a><span class="lineno"> 2302</span><span class="keywordtype">int</span> RUN_ALL_TESTS() GTEST_MUST_USE_RESULT_;</div>
<div class="line"><a id="l02303" name="l02303"></a><span class="lineno"> 2303</span> </div>
<div class="line"><a id="l02304" name="l02304"></a><span class="lineno"> 2304</span>inline <span class="keywordtype">int</span> RUN_ALL_TESTS() { return ::testing::UnitTest::GetInstance()-&gt;Run(); }</div>
<div class="line"><a id="l02305" name="l02305"></a><span class="lineno"> 2305</span> </div>
<div class="line"><a id="l02306" name="l02306"></a><span class="lineno"> 2306</span>GTEST_DISABLE_MSC_WARNINGS_POP_()  <span class="comment">//  4251</span></div>
<div class="line"><a id="l02307" name="l02307"></a><span class="lineno"> 2307</span> </div>
<div class="line"><a id="l02308" name="l02308"></a><span class="lineno"> 2308</span><span class="preprocessor">#endif  </span><span class="comment">// GOOGLETEST_INCLUDE_GTEST_GTEST_H_</span></div>
<div class="ttc" id="aclass_floating_point_html"><div class="ttname"><a href="class_floating_point.html">FloatingPoint</a></div><div class="ttdef"><b>Definition</b> gtest-internal.h:245</div></div>
<div class="ttc" id="aclass_test_event_listener_html"><div class="ttname"><a href="class_test_event_listener.html">TestEventListener</a></div><div class="ttdef"><b>Definition</b> gtest.h:919</div></div>
<div class="ttc" id="aclass_test_info_html"><div class="ttname"><a href="class_test_info.html">TestInfo</a></div><div class="ttdef"><b>Definition</b> gtest.h:527</div></div>
<div class="ttc" id="aclass_test_result_html"><div class="ttname"><a href="class_test_result.html">TestResult</a></div><div class="ttdef"><b>Definition</b> gtest.h:393</div></div>
<div class="ttc" id="aclass_test_suite_html"><div class="ttname"><a href="class_test_suite.html">TestSuite</a></div><div class="ttdef"><b>Definition</b> gtest.h:666</div></div>
<div class="ttc" id="aclasstesting_1_1_empty_test_event_listener_html"><div class="ttname"><a href="classtesting_1_1_empty_test_event_listener.html">testing::EmptyTestEventListener</a></div><div class="ttdef"><b>Definition</b> gtest.h:986</div></div>
<div class="ttc" id="aclasstesting_1_1_environment_html"><div class="ttname"><a href="classtesting_1_1_environment.html">testing::Environment</a></div><div class="ttdef"><b>Definition</b> gtest.h:887</div></div>
<div class="ttc" id="aclasstesting_1_1_message_html"><div class="ttname"><a href="classtesting_1_1_message.html">testing::Message</a></div><div class="ttdef"><b>Definition</b> gtest-message.h:92</div></div>
<div class="ttc" id="aclasstesting_1_1_test_event_listener_html"><div class="ttname"><a href="classtesting_1_1_test_event_listener.html">testing::TestEventListener</a></div><div class="ttdef"><b>Definition</b> gtest.h:919</div></div>
<div class="ttc" id="aclasstesting_1_1_test_event_listeners_html"><div class="ttname"><a href="classtesting_1_1_test_event_listeners.html">testing::TestEventListeners</a></div><div class="ttdef"><b>Definition</b> gtest.h:1016</div></div>
<div class="ttc" id="aclasstesting_1_1_test_html"><div class="ttname"><a href="classtesting_1_1_test.html">testing::Test</a></div><div class="ttdef"><b>Definition</b> gtest.h:242</div></div>
<div class="ttc" id="aclasstesting_1_1_test_info_html"><div class="ttname"><a href="classtesting_1_1_test_info.html">testing::TestInfo</a></div><div class="ttdef"><b>Definition</b> gtest.h:527</div></div>
<div class="ttc" id="aclasstesting_1_1_test_property_html"><div class="ttname"><a href="classtesting_1_1_test_property.html">testing::TestProperty</a></div><div class="ttdef"><b>Definition</b> gtest.h:363</div></div>
<div class="ttc" id="aclasstesting_1_1_test_result_html"><div class="ttname"><a href="classtesting_1_1_test_result.html">testing::TestResult</a></div><div class="ttdef"><b>Definition</b> gtest.h:393</div></div>
<div class="ttc" id="aclasstesting_1_1_test_suite_html"><div class="ttname"><a href="classtesting_1_1_test_suite.html">testing::TestSuite</a></div><div class="ttdef"><b>Definition</b> gtest.h:666</div></div>
<div class="ttc" id="aclasstesting_1_1_test_with_param_html"><div class="ttname"><a href="classtesting_1_1_test_with_param.html">testing::TestWithParam</a></div><div class="ttdef"><b>Definition</b> gtest.h:1698</div></div>
<div class="ttc" id="aclasstesting_1_1_unit_test_html"><div class="ttname"><a href="classtesting_1_1_unit_test.html">testing::UnitTest</a></div><div class="ttdef"><b>Definition</b> gtest.h:1104</div></div>
<div class="ttc" id="aclasstesting_1_1_with_param_interface_html"><div class="ttname"><a href="classtesting_1_1_with_param_interface.html">testing::WithParamInterface</a></div><div class="ttdef"><b>Definition</b> gtest.h:1664</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_assert_helper_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_assert_helper.html">testing::internal::AssertHelper</a></div><div class="ttdef"><b>Definition</b> gtest.h:1590</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_default_global_test_part_result_reporter_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_default_global_test_part_result_reporter.html">testing::internal::DefaultGlobalTestPartResultReporter</a></div><div class="ttdef"><b>Definition</b> gtest-internal-inl.h:465</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_eq_helper_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_eq_helper.html">testing::internal::EqHelper</a></div><div class="ttdef"><b>Definition</b> gtest.h:1376</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_final_success_checker_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_final_success_checker.html">testing::internal::FinalSuccessChecker</a></div><div class="ttdef"><b>Definition</b> gtest-unittest-api_test.cc:224</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_g_test_flag_saver_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_g_test_flag_saver.html">testing::internal::GTestFlagSaver</a></div><div class="ttdef"><b>Definition</b> gtest-internal-inl.h:138</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_mutex_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_mutex.html">testing::internal::Mutex</a></div><div class="ttdef"><b>Definition</b> gtest-port.h:1842</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_parameterized_test_factory_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_parameterized_test_factory.html">testing::internal::ParameterizedTestFactory</a></div><div class="ttdef"><b>Definition</b> gtest-param-util.h:396</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_parameterized_test_suite_registry_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_parameterized_test_suite_registry.html">testing::internal::ParameterizedTestSuiteRegistry</a></div><div class="ttdef"><b>Definition</b> gtest-param-util.h:689</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_random_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_random.html">testing::internal::Random</a></div><div class="ttdef"><b>Definition</b> gtest-internal.h:868</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_test_event_listeners_accessor_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_test_event_listeners_accessor.html">testing::internal::TestEventListenersAccessor</a></div><div class="ttdef"><b>Definition</b> gtest_unittest.cc:153</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_test_event_repeater_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_test_event_repeater.html">testing::internal::TestEventRepeater</a></div><div class="ttdef"><b>Definition</b> gtest.cc:3765</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_test_result_accessor_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_test_result_accessor.html">testing::internal::TestResultAccessor</a></div><div class="ttdef"><b>Definition</b> gtest-internal-inl.h:1035</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_unit_test_impl_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_unit_test_impl.html">testing::internal::UnitTestImpl</a></div><div class="ttdef"><b>Definition</b> gtest-internal-inl.h:504</div></div>
<div class="ttc" id="aclasstesting_1_1internal_1_1_unit_test_record_property_test_helper_html"><div class="ttname"><a href="classtesting_1_1internal_1_1_unit_test_record_property_test_helper.html">testing::internal::UnitTestRecordPropertyTestHelper</a></div><div class="ttdef"><b>Definition</b> gtest_unittest.cc:177</div></div>
<div class="ttc" id="astructtesting_1_1internal_1_1_code_location_html"><div class="ttname"><a href="structtesting_1_1internal_1_1_code_location.html">testing::internal::CodeLocation</a></div><div class="ttdef"><b>Definition</b> gtest-internal.h:490</div></div>
<div class="ttc" id="astructtesting_1_1internal_1_1_trace_info_html"><div class="ttname"><a href="structtesting_1_1internal_1_1_trace_info.html">testing::internal::TraceInfo</a></div><div class="ttdef"><b>Definition</b> gtest-internal-inl.h:456</div></div>
<div class="ttc" id="astructtesting_1_1internal_1_1faketype_html"><div class="ttname"><a href="structtesting_1_1internal_1_1faketype.html">testing::internal::faketype</a></div><div class="ttdef"><b>Definition</b> gtest.h:1360</div></div>
</div><!-- fragment --></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  <ul>
    <li class="navelem"><a class="el" href="dir_4335ce4a64d0d4f9f4c8f0a782dfdfeb.html">Build</a></li><li class="navelem"><a class="el" href="dir_52591f05075520724bd5e6f6d1d2f7f0.html">_deps</a></li><li class="navelem"><a class="el" href="dir_f332dbc5c9861f18ba978cecf6e1ca1f.html">googletest-src</a></li><li class="navelem"><a class="el" href="dir_fa0a5970d155220a13af9b0a6b4c2b33.html">googletest</a></li><li class="navelem"><a class="el" href="dir_4b6a54270fd07123e628a0a16184198f.html">include</a></li><li class="navelem"><a class="el" href="dir_e1f2723e4b13487b8e9752fb843acf29.html">gtest</a></li><li class="navelem"><b>gtest.h</b></li>
    <li class="footer">Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.13.2 </li>
  </ul>
</div>
</body>
</html>
